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ABSTRACT 



This final report contains a detailed description of six 
software systems designed to assist individuals with blindness and/or speech 
disorders in using inexpensive, off-the-shelf computers rather than expensive 
custom-made devices. The developed software is not written in the native 
machine language of any particular brand of computer, but in the universal 
language "C, " which will run on all present and future brands of computers. 
The report provides user manuals describing the software for individuals with 
blindness, "Screen-Voice," adapted to three types of computer in use in 1984, 
the Apple lie (the most popular computer in schools) ; IBM compatible personal 
computers (the most popular office computer, available in tabletop and 
portable versions) ; and the TRS-80 Model t. 00. (a portable computer) . The 
report includes user manuals for "Talkhelper, " a program designed to allow 
persons with speech disabilities to use a personal computer with a speech 
synthesizer as a substitute voice. Manuals are also provided for Apple lie, 
IBM- compatible computers, and for the TRS-80 Model 100 portable computer. 
Finally, the source code of the most elaborate version of the software, that 
of the IBM- compatible personal computer, is reproduced in full. (CR) 
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INTRODUCTION 



This is the final substantive report submitted by Visek & 

Maggs» contractor under United States Department of Education 
Contract No. 300-83-0271 » "A Talking Computer System for Persons 
with Vision and Speech Contracts." This report contains a 
detailed description of the six software/hardware systems 
designed and tested by Visek &. Maggs in accordance witht the 
terms of this contract. 

The basic philosophy of the contract proposal and the Design 
Report developed under the contract was that) with appropriate 
software) persons with vision and speech handicaps could use 
inexpensive off-the-shelf computers rather than expensive custom 
made devices. This philosophy was based on the tremendous 
success of previous work by the two general partners in the 
contractor organization in designing the speech and blind user 
software for the Echo II Synthesizer for the Apple computer » 
software that was instrumental in making artificial speech 
available on a mass-produced basis at a highly affordable price. 

However » despite its wide acceptance) this early software 
had two serious drawbacks. First it required substantial 
additional programming to be of any use to speech-handicapped 
persons. Second) it was written in machine language for the 
obsolescent Apple II computer and could not easily be transferred 
to other machines. 

To meet the requirements of the speech-handicapped) contractors 
developed a highly sophisticated authoring and customization 
system) allowing the speech-handicapped person or an assistant to 



customize the software to meet the particular combination of 
handicaps and needs of the particular individual. 

The software developed previously is not suitable for the 
IBM-compatible personal computers that have become the standard 
in many business offices, nor for the most popular brand of 
portable computer, the TRS-80 Model 100, nor for the many new 
types of computers sure to appear in the next few years in this 
area of rapidly changing technology. The software developed 
under the present contract is written not in the native machine 
language of the Apple II or any other particular brand of 
computer, but in the universal language "C" , which will run on 
all present and future brands of computers. Thus this software 
can still bring benefits to persons with vision and speech 
handicaps long after the present generation of computers is 
obsolete. 

The material which follows describes in detail the software 
for blind users, Screen-Voice, as adapted to three types of 
computer: the Apple lie (the most popular computer in schools), 

IBM-compatible personal computers (the most popular office 
computers, available in tabletop and portable versions), and the 
TRS-80 Model 100 (the most possible portable computer). Finally 
the source code of the most elaborate versions of the software, 
those for the IBM-compatible personal computers is reproduced in 



^ SCREEN-VOICE 

fl Software to Adapt the IBM Personal Computer for Blind Users 

M USER’S MANUAL 

I 

■ This manual and the accompanying software 

^ were developed under United States Department 

of Education Contract No. 300-83-0271. 
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PREFACE 



This user’s manual tells how to set the switches on a speech 
synthesizer and how to install the Screen-Voice software for the 
IBM Personal Computer? and provides instructions for blind users 
of the software. This manual assumes the IBM Personal Computer 
is set up and ready to operate? and that the speech synthesizer 
has been connected to the computer in accordance with the 
instructions supplied with the synthesizer. 

Purposes- of The Manual 

This manual has five purposes: 

1. To tell you how to set up your computer and speech 
synthesizer for use with the Screen-Voice software. 

2. To guide you in getting the Screen-Voice software working. 

3. To explain the options for reading from the computer screen. 

A . To explain the options for controlling the types of output. 

5. To help you set up special pronunciation tables. 
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INTRODUCTION 

The Screen-Voice software for the IBM Personal Computer is a 
program that provides two essential services for the blind user. 
First? it sends to the speech synthesizer a copy of everything 
that appears on the screen? to be spoken as it appears on the 
screen. Second? it allows the user to select parts of the 
contents of the screen for review? replaying individual lines? 
words? or letters. 

SYSTEM REQUIREMENTS 

This software is designed for use with the IBM Personal 
Computer and any of the following brands of speech synthesizers 
Echo GP? Intextalker , Microvox? or Votrax Personal Speech System. 
The software may work with some IBM-compatible personal 
computers and can be adapted for other synthesizers as explained 
in the final section of this manual. 

USING SOFTWARE DEVELOPED FOR SIGHTED USERS 
OF IBM PERSONAL COMPUTERS 

Many? but by no means all? software programs developed for 
sighted users of the IBM Personal Computer can be used with 
Screen-Voice. For instance? blind users can write and run 
programs in the BASIC programming language supplied with the IBM 
Disk Operating System. Many commercially available programs will 
also work. Some? however? will not work. 
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There are three possible types of problems in using 
commercially available programs. First, some commercial programs 
are supplied on diskettes which incorporate special features to 
prevent illegal copying. Some of these programs will incorrectly 
identify an attempt to use Screen-Voice as an attempt to make an 
illegal copy and may refuse to cooperate with Screen-Voice. 
Second, some programs write information directly to the computer 
screen, bypassing the standard IBM screen output software built 
into the computer and its operating system. This technique gives 
faster performance for these programs, but makes it impossible 
for Screen-Voice to capture abd speak the programs’ output. 

Third, some programs, because they depend heavily on graphics or 
screen location of text, are difficult to describe verbally. 

Thus they are unsuitable for blind users. 

Screen-Voice will work well with software developed 
especially for blind users. This software, for purposes such as 
word processing and data base management, makes use of the power 
of the computer to search for the words that blind users want to 

i 

change or the information they want to get. 

HOW MUCH OF THIS MANUAL DO I NEED TO READ?. 

The most essential part of the manual deals with screen 
review and output control features of Screen-Voice. You must 
thoroughly familiarize yourself with these features. However, 
don’t worry about forgetting some of them — you can have the 
computer help you while you are running a program, without 
interfering with the operation of the program. 
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If you are planning to install your synthesizer and 
Screen-Voice yourself, you must study the sections of this 
manual on installation before you try to use Screen-Voice. If 
someone else does the installation, they must read those 
sec t i ons . 

The custom pronunciation table feature is a part of the 
manual that can be left until later. You may find that the brand 
of synthesizer you have selected mispronounces some words — your 
last name, for instance. The custom pronunciation table will let 
you enter the pr onunc i a t i on you want for these words. 

Unless you intend to use a brand of synthesizer other than 
the Echo II, Intextalker , Microvox, or Votrax Personal Speech 
System, you can completely ignore the section of the manual on 
adapting Screen-Voice for use with other synthesizers. 
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SETTING THE SPEECH SYNTHESIZER SWITCHES 



The speech synthesizer must be attached to the computer in 
accordance with the instructions provided by the synthesizer 
manufacturer in the manual that comes with the synthesizer. If 
the manufacturer provides a demonstration diskette, it must be 
used to test the speech synthesizer once it is installed. A blind 
user will find it very convenient to plug the computer, speech 
synthesizer, and the video monitor (if he or she has one) into a singl 
power strip so that they may all be turned on with one switch. 

Most brands of speech synthesizer have optional switch 
settings. These switches must be set as follows: 

Echo GP: 

The switches are located on the bottom of the synthesizer 
near the middle of the back. (The back is the side where the 
wires come out.) There is a square hole in the back of the 
synthesizer, and in this hole are four tiny switches. The part 
of each switch toward the back of the synthesizer must be 
pushed inward. This will turn these switches on and will set the 
synthesizer for 9600 baud, which means high-speed communication 
of information from the computer to the synthesizer. 



Intextalker and Microvox: 

The hardware of these two synthesizers is identical. The 
switches are located inside the synthesizer. Make sure the 
synthesizer is unplugged from the electric power line before 
attempting to change the switches! Get a Phillips screwdriver. 
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Turn the synthesizer upside down find the heads of two screws. 

One is located in the middle of the right side of the bottom of 
the synthesizer, just in from the edge; the other screw is 
located in the middle of the left side of the bottom of the 
synthesizer , just in from the edge. Remove the two screws, turn 
the synthesizer right side up and remove the top cover. 

Now place the synthesizer with the side with the volume 
control knob toward you. There are two sets of eight switches 
that will have to be set. The first set is located halfway 
between the right and left edges of the circuit board inside the 
synthesizer, about one inch back from the front of the board. 
Switch number ^ , which is the fourth switch from the rear of the 
board on this set of switches, must be pushed to the right. 

The other switches must be pushed to the left. This will set 
the communicat ions rate to 1500 baud or medium speed. 

The second set of switches is located very near the right 
hand edge of the board, about three inches back from the front of 
the board. On this set of switches, switches 1, 5, and 8 (the 
first, second, and eighth switches from the rear of the board) 
must be set to the right. The others must be set to the 
left. This will provide for what is called "hardware 
handshaking" — sending electronic signals to coordinate the 
activity of the synthesizer and the computer. If you have the 
Intex upgrade for improved pronunciation, switch settings may be 
different, as described in the instructions that come with this 
upgrade . 
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Votrax Personal Speech System: 

Turn the synthesizer so the volume control is away from you. 

On the part of the synthesizer that is now toward you, about 
three inches leftward from the right side is an oblong hole, 
about one-third of an inch high and one inch wide. A set of 
eight switches is recessed about one-half an inch behind this 
hole. The switches must all be pushed down, except switch 6 
(the sixth from the left), which must be pushed up. In case 
you are interested, the technical terms for these switch settings 
are: 9600 baud, RTS serial port communication, 7 bit word with 

ignored parity bit, power-up message spoken, serial port used as 
primary input port, and self-test off. 
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GETTING STARTED 



We will first list and then explain in detail the steps in 
getting started with your Screen-Voice software. Experienced IBM 
users may read the headings to determine which sections they 
already know. The installation procedure described below will 
inform Screen-Voice of the brand of synthesizer you are using? so 
it can customize itself for this brand. It will also copy some 
copyrighted IBM software from the IBM DOS diskette to the 
Screen-Voice diskette. (The copyright laws do not allow 
distribution of this software on the Screen-Voice diskette? but 
they do allow you to make a copy of it for your personal use if 
you own a genuine copy of IBM DOS.) Finally? the manual will 
explain how to make working copies of your Screen-Voice diskette 
so that the original can be kept in a safe place as a backup 
copy . 

PREPARATIONS 

Make sure your synthesizer is plugged in? turned on? and 
connected to the computer? and that the computer is plugged in 
but turned off. 

STARTING UP THE COMPUTER 

Get your DOS (Disk Operating System) disk. You must have 
IBM DOS 2.0 or a higher number — DOS 1.1 for instance will not 
work. If you do not have the right version of DOS? show these 
instructions to your IBM dealer? who wiTl be delighted to sell 
you the appropriate version of DOS. 

Now we will .explain for new IBM users how to put this disk 
in the computer and how to start the computer running. In the 
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front of the box that encloses the main computer unit there will 
be one or two disk drives. The disk drive or drives will be 
located in a recessed area about IS inches long and three inches 
high. The disk drive you want is located in the left half of 
this recessed area. It is called Drive A by IBM. If you feel 
the front of this drive, you will feel two thin horizontal 
slots* one on the right and one on the left. Between them is the 
door of the diskette drive. If the door is closed there will 
still be a recess below it. If the door is open, the recess will 
extend above and below the slots and you will be able to feel the 
open door near the top of the middle of the disk drive. Practice 
opening and closing the door and then leave it open. 

Now pick up the DOS diskette, which will be in a paper 
cover . Handle the diskette only by the edges, so as to avoid 
damaging its sensitive recording surfaces. Remove the diskette 
from the paper cover and feel around the edges. You will find 
two very small notches on one side and one larger notch on 
another side. Now hold this diskette horizontally, so that the 
two small notches are on the side toward the computer and the 
larger notch is to the left. Making sure the door is open, 
insert the diskette in the slot in Drive A and push it all the 
way in. Do not force it. Now close the door. Do not force the 
door closed if something is blocking it or you could damage the 
diskette. 

Now, turn on the computer. The diskette unit will whir 
for a while and then fall silent. At this point the computer 
will not be talking, but unless it has an automatic clock, it 



O 

ERIC 

himiaitffiKiflaa 



9 



16 



will be writing a message on the screen to ask the time. To 
bypass the request for the time, do the following. Without 
pressing any keys, put your finger at the right top corner key on 
the keyboard. Still without pressing any keys, move your finger 
two keys to the left of the right top corner key. Now move your 
finger to the key below this. Your finger will be on the 
ENTER key. Press it twice. 

INSTALLING SCREENREADER 

The following procedures will install Screen-Voice and tell 
it what brand of synthesizer you are using. Note: If you change 

brands of synthesizer you will need to repeat this procedure. 
During the process parts of DOS will be copied automatically to 
your Screen-Voice diskette so that you can later use that 
diskette to start up your computer. 

First we will give a summary for experienced IBM users; 
then we will give a much more detailed explanation for new users. 
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Summary for Experienced Users 

Make sure that your synthesizer has been turned on, so that 
you will hear any message Screen-Voice may send to it. If you 
have two floppy diskette drives, leave your DOS disk in drive A 
and insert the Screen-Voice diskette into drive B. Type "b:" 
followed by the first letter of the name of your synthesizer. 

For Intextalker, type "i"; for Microvox, type "m"; for Echo GP , 
type "e"; for Votrax Personal Speech System, type "v". After a 
moment, the synthesizer should say "Screen-Voice by Visek and 
Maggs" and "configured for" followed by the brand name of your 
synthesizer . 
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If you have only one floppy diskette drive (with or without 
a hard disk drive), leave the DOS diskette inserted and type "b:" 
followed by the letter corresponding to your synthesizer as given 
above. Since the installation program needs to copy some DOS 
files onto your Screen-Voice diskette, you will need to switch 
diskettes and press the ENTER key each time you year the disk 
drive stop. After several switches, the synthesizer should say 
"Screen-Voice by Visek and Maggs" and "configured for" followed 
by the name of your synthesizer. 

Instructions for New Users 

First make sure that your synthesizer is turned on, so that 
you will hear any message Screen-Voice sends to it. The 
procedure beyond this point depends upon what type of disk drives 
your computer has. The following instructions will cover in turn 
computers with two floppy diskette drives and computers with one 
floppy diskette (with or without a hard disk drive). 

If you have one floppy diskette drive and one hard disk 
drive, skip to the section below called "Instructions for New 
Users with Only One Floppy Diskette Drive." If you have two 
floppy diskette drives, continue reading. 

Instructions for New Users with Two Floppy Diskette Drives 

The next step is to place the Screen-Voice diskette in the 
right hand drive, drive B. Now what you do depends on what brand 
of synthesizer you have: 
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If you have an Intextalker > type: 

b : i 

and then press the ENTER key. 

If you have a Microvox> type: 

b : m 

and then press the ENTER key. 

If you have an Echo GP? type: 

b : e 

and then press the ENTER key. 

If you have a Votrax personal speech system? type: 

b : v 

and then press the ENTER key. 

By typing "b: M you have told the computer to look on the 
diskette in the right hand drive? drive B? for the file specified 
by the letter correspond i ng to your synthesizer. The diskette 
drives will whir and when they stop whirring the synthesizer 
should say "Screen-Voice by Visek and Maggs?" and “configured 
for"? followed by the name of your synthesizer. 

Instructions for Users with Only One Floppy Diskette Drive 

If you have only one floppy diskette drive? with or without 
a hard disk drive? the procedures are more complicated. Remove 
the DOS diskette and insert the Screen-Voice diskette. Type the 
following depending upon your brand of synthesizer: 
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If you have an Intextalker? type 



b : i 

and then press the ENTER key. 

If you have a Microvox, type: 

b : m 

and then press the ENTER key. 

If you have an Echo GP ? type: 

b : e 

and then press the ENTER key. 

If you have a Votrax personal speech system? type: 

b : v 

and then press the ENTER key. 

The diskette drive will whir. When it stops? remove the DOS 
diskette? insert the Screen-Voice diskette and press the ENTER 
key. The drive will whir again. When it stops? remove the 
Screen-Voice diskette and insert the DOS diskette. Press ENTER. 
The diskette drive will again whir and stop. Switch diskettes 
and then press ENTER each time the drive stops? until the 
synthesizer says "Screen-Voice by Visek and Maggs?” and 
"configured for" followed by the name of your synthesizer. 



MAKING WORKING COPIES OF VOUR SCREENREADER DISKETTE 

If you are an experienced IBM Personal Computer user? make 
some working copies of the Screen-Voice diskette using the 
DISKCOPV command. (The Screen-Voice diskette is not copy- 





protected.) Experienced users may skip the following detailed 
instructions on making extra copies. 

Now we will explain how to make working copies of your 
Screen-Voice diskette. It is important to make several working 
copies so that you can put the original diskette and one working 
copy in a safe place as a backup in case the copy you are using 
is accidently damaged or erased or physically wears out. 

Remove the Screen-Voice diskette and cover the large notch 
with one of the special wr i te-pro t ec t stickers provided with each 
box of blank diskettes. These stickers are about one inch by 
one-quarter inch. (Notes They are not the bigger stickers 
provided for use as labels.) When the notch is covered, the 
diskette drive cannot alter the contents of the diskette, so by 
covering the notch, you can protect your diskette from accidental 
modification. Now get a blank diskette to use in making a copy 
of Screen-Voice. The copy procedure depends on the number of 
floppy disk drives you have. 

Making Working Copies if You Have Two Diskette Drives 

If you have two floppy diskette drives, insert the DOS 
diskette in drive A (the left hand drive) and a blank diskette in 
drive B (the right hand drive). Now type the following and then 
press the ENTER key once: 



diskcopy a: b: 

When Drive A stops whirring, remove the DOS diskette from drive A 
and place the Screen-Voice diskette in drive A. Press the ENTER 
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key. The drives will whir for quite a while as they copy all the 
information from the Screen-Voice diskette to the new diskette 
you have in Drive B. When the whirring stops, the copying is 
done . 



Making Working Copies if You Have One Floppy Diskette Drive 







Now we will explain how to make working copies of your 
Screen-Voice diskette if you have only one floppy diskette drive. 
Insert the DOS diskette in the floppy diskette drive. - Then type 
the following and then press the ENTER key once: 

diskcopy a: b: 

The Screen-Voice diskette is called the "source" diskette and the 
blank diskette is called the "target" diskette. The synthesizer 
will tell you when to insert a diskette or press a key. It will 
notify you when the copy is done and ask if you want to make 
another copy. Press the "Y" or "N" keys, depending on what you 
want to do. 

USING SCREENREADER 

Once you have configured your Screen-Voice diskette and made 
working copies of it, using Screen-Voice is very simple. All you 
will need to do is to put a working copy in drive A before 
turning on the computer. When the computer is turned on, the 
Screen-Voice software appropriate for your synthesizer will be 
loaded automatically into your computer and the synthesizer will 
say "Screen-Voice ready." You may then replace the working copy 
of the Screen-Voice diskette with one of your program diskettes. 
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If you turn the computer off> you will have to put a copy of the 
Screen-Voice diskette in drive A before you turn it on again. 
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OUTPUT CONTROL FEATURES 



When your computer is turned on and Screen-Voice is 
activated, it automatically selects a number of standard or 
,, default , ‘ features for reading what is sent to the screen. 
However, for special purposes you may want to choose other 
features. This chapter explains the standard features and your 
options for varying them. 

The standard features for Screen-Voice attempt to imitate 
what a sighted person would say if asked to read what was written 
on the screen. The special features allow various types of more 
detailed reading, for tasks such as proofreading. They also 
allow less detailed reading to enable rapid skimming of the text 
on the screen. 
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How to Select an Output Control Feature 

To select an output control feature, hold down the Control 
key (the key immediately to the left of the A key), and while 
holding it down press the E key. This combination is called 
Control-E. The next step is to release these two keys and press 
the command key given below for the feature desired. In some 
cases it will also be necessary to type a number. For these 
commands, upper case and lower case letters have the same 
specified effect. 

An attempt has been made to choose command keys so that the 
letters on the keys are related to the first letters of the names 
of the commands, but this has not always been possible. Single- 
key commands rather than whole-word commands are used because, 
although they are harder to remember, they are much faster to use 
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after some practice, 
commands in a r ow and 
computer is accepting 



One can issue any number of Screen-Voice 
commands may be issued at any time the 
key presses. 



GENERAL PRONUNCI ATION FEATURES 

Most speech synthesizers allow commands to be sent by the 
computer to control synthesizer pitch, volume, speed, and 
intonation. Details vary from synthesizer to synthesizer. Thus 
the commands described here for varying synthesizer voice 
characteristics may have different effects with different 
synthesizers. If a particular brand of synthesizer lacks certain 
pronunciation features, the command may have no effect, but will 
do no harm. 

I nt ona t ion 

Most synthesizers allow the user to select either an 
imitation of human speech intonation or robot-like flat speech. 
Some people prefer the flat speech because no synthesizer selling 
for less than $^000 offers good intonation. Others find flat 
speech boring and prefer inaccurate intonation. Screen-Voice 
sets the synthesizer initially to provide intoned speech. To 
switch to flat speech type Control-E and then I. To switch back 
to intoned speech, type Control-E and I again. 

Remember: I is for Intonation on or off. 

Speech Rate 

Most synthesizers allow the user to control the rate of 
speech. Blind persons who are experienced with speech 



synthesizers usually like to run them as fast as possible? so as 



to increase their effective reading speed. However? even 
experienced users sometimes need to slow down the synthesizer for 
difficult passages. To set the synthesizer speech rate? type 
Control-E? then R? and then a letter from A to Z. The letter A 
stands for the slowest rate? the letter Z for the fastest rate 
and other letters for rates in between. If your synthesizer has 
only one rate? this command will have no effect. If your 
synthesizer has only two rates? letters in the first half of the 
alphabet will select the slower rate? and letters in the second 
half of the alphabet will select the faster rate. The initial 
rate is programmed into the synthesizer by its manufacturer. For 
some synthesizers? such as the Intextalker or Hicrovox? changing 
the rate may also change the pitch. 



Remembers R is for Rate; 

the following letter selects the rate. 

Vo 1 ume 

Some synthesizers allow users to control speech volume 
through the computer. Others offer a convenient volume control 
knob on the synthesizer. Still others have both options. To set 
the volume through the computer? type Control-E? then V? and then 
a letter from A to Z. If the synthesizer has computer- 
controllable volume? the letter A will produce the softest 
volume? the letter Z the loudest? and other letters will produce 
intermediate volume levels. If the synthesizer has less than 26 
different levels of controllable volume? letters close together 
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in the alphabet may not produce different volumes. On most 
synthesizers, use of the volume control knob on the synthesizer 
itself is a better way to change volume. The initial volume is 
programmed into the synthesizer by its manufacturer. 

Remember: V is for Volume; 

the following letter selects the volume. 

Pitch 

Some synthesizers allow computer control of speech pitch. 

It may lessen fatigue to vary the pitch from time to time so as 
not to listen to the same voice for hours on end. To set the 
pitch control through the computer type Control-E, then P, and 
then a letter from A to Z. If the synthesizer has computer- 
controllable pitch, the letter A will produce the softest pitch, 
the letter Z the loudest, and other letters will produce 
intermediate pitch levels. If the synthesizer has less than 26 
different levels of controllable pitch, letters close together in 
the alphabet may not produce different pitch levels. The initial 
pitch is programmed into the synthesizer by the synthesizer 
manufacturer. For some synthesizers, such as the Intextalker or 
Microvox, pitch can also be varied by changing the rate. 

Remember: P is for Pitch; 

the following letter selects the pitch. 



Pauses 

Scientific research shows that it is easier to understand 
speech synthesizers if they are programmed to pause briefly 
between words. However, the pauses slightly slow down the 
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reading speed. When Screen-Voice starts running, it does not add 
pauses between words; however there is an option to add pausing. 
Some synthesizers, such as the Votrax Personal Speech System, 
automatically provide a short pause between words. With these 
synthesizers, if Screen-Voice is set for pausing, there will be 
an extra long pause between words. To switch between not pausing 
and pausing, press Control-E, and then letter E. To switch back, 
use the same command. 

Remember: E is for Enunciation on or off. 

Custom Pro nunc i a t i on 

Sometimes synthesizers mispronounce words or fail to handle 
abbreviations properly. Sometimes users get tired of hearing 
long words pronounced in full over and over again. The custom 
pronunciation table feature, discussed in more detail in a later 
chapter, allows the user to specify the desired pronunciation for 
each word in a list. When Screen-Voice is activated, the 
substitutions provided in this table are automatically put into 
effect whenever screen-Voice is in normal speech mode. (When the 
synthesizer is spelling letter by letter or with the "Alpha, 
Bravo, Charlie” alphabet, custom pronunciation is temporarily 
suspended, because it is assumed that the user is using these 
modes to find out in detail what is actually on the screen.) To 
switch between custom and regular pronunciation, type Control-E 
followed by C. To switch back, use the same command. 

Remember: C is for Custom pronunciation on or off. 
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FEATURES FOR MORE DETAILED READING 



The usual way of reading text does not bring out all the detail 
necessary for proof r ead i ng . The proofreading features of 
Screen-Voice allow the user to have just the amount of extra 
detail he or she wants for the particular task at hand. 

Spelling or Whole Words 

When Screen-Voice is activated it reads by whole words. For 
proofreading it may be necessary to have individual words spelled 
out? since two words may be spelled differently but pronounced 
the same (for instance " t h e i r “ and "there"). A word 
could be spelled wrong but pronounced correctly (for instance 
"t h a i r" will be pronounced "there") or spelled correctly but 
pronounced wrong due to a shortcoming of the speech synthesizer. 

To have words spelled out? type Control-E? and then L. To return 
to normal whole word pronunciation press Control-E and then N. 

Some people have trouble understanding a synthesizer when it 
is spelling letter by letter. To have spelling done not with 
letters? but with the "Alpha? Bravo? Charlie" alphabet? press 
Control-E and then type B. 

Remember: L for Letter by letter spelling; 

B is for Alpha? Bravo? Charlie spelling; 

N is for Normal (whole word) pronunciation. 

Capital Letters 

Proofreading may require distinguishing upper case from 
lower case letters. To have upper case letters indicated? press 
Control-E and then U. The computer will then say "cap" before 
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each upper case letter. To go back to regular reading, press 
Control-E and then U again. 

Remember: U is for Upper case on or off. 

Pune tua t ion 

In normal reading, special symbols such as "$ M and "+" are 
usually read out, but common punctuation marks such as period and 
comma are not pronounced. When Screen-Voice starts, it is in 
normal reading mode. All special symbols and all punctuation on 
the screen are pronounced except the following: dash, period, 

comma, semicolon, exclamation point, question mark, star, double 
quotes, apostrophe, tilde, grave accent, vertical line, 
backslash, left parenthesis, right parenthesis, left bracket, 
right bracket, left brace, and right brace. When reading 
numbers, a decimal point will be pronounced as point. If a 
combination of digits, dollar signs, commas, and periods is 
encountered that is not a well-formed number or monetary amount, 
all characters will be pronounced to alert the user to the 
unusual situation. 

This option is called "Some" punctuation. If you have 
switched to another punctuation option, you can return to "Some" 
punctuation by typing Control-E and then S. 

When pr oof r ead i ng , it is usual to pronounce all punctuation 
but not to indicate spaces. This option is called “Most" 
punctuation. It is available by pressing Control-E and then M. 



Finally* for some purposes it is necessary to know exactly 
what is on the screen, including spaces. This option, called 
"All" punctuation, is available by pressing Control-E and then A. 

None of these modes provides an indication of video cursor 
movement about the screen. Positions of this cursor may be 
checked at any time the computer is accepting input, by using the 
video cursor command described below. 

Remember: S is for Some punctuation; 

M is for host punctuation; 

A is for All punctuation. 

Number s 

The reading of numbers also differs in ordinary speech and 
in proofreading. In normal speech, for instance, a three 
followed by a four followed by a five is pronounced "three 
hundred forty five." When proof r ead i ng , the same number is 
pronounced digit by digit, as “three four five.” When 
Screen-Voice starts, numbers are pronounced in normal speech 
mode, except for combinations of digits, commas, dollars signs 
and periods that constitute neither well-formed numbers nor 
proper monetary amounts. These combinations, such as are 

spoken character-by-character . To switch between normal speech 
mode and digit-by-digit mode type Control-E and then D. To 
switch back, use the same command. 

Remember: D is for Digits on or off. 
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FEATURES FOR LESS DETAILED READING 



The following options allow text to be read faster by 
skipping portions of it. (Remember also that setting the 
synthesizer to a fast speech rate? as explained earlier? will 
speed up reading without loss of any text.) 

Sk imming 

Often a user wishes to skim through text to see if it is of 
any interest. A skimming option is available that just reads the 
long words in the text? those with seven or more letters. 

Numbers and strings of punctuation and other symbols are skipped 
regardless of length. To just read these big words? type 
Control-E and then J. To return to ordinary reading? type 
Control-E and J again. 

Remember: J is for Just reading long words. 

Ignore Top Lines 

Normally Screen-Voice reads everything that appears on the 
screen. However? some programs continually write status 
information on top line of the screen. This information? such as 
the number of the column currently being written? is of little 
value to the blind user? and is highly annoying when it 
interrupts spoken text. To set the computer to ignore lines at 
the top of the screen? type Control-E? then T? then a letter from 
A to V. The letter indicates the first line that will be 

pronounced. If the letter is A? the whole screen will be 

pronounced. If the letter is B? pronunciation will start at the 

second line on the screen? if it is C? pronunciation will start 
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at the third line on the screen. The letter Y turns off speech 
on all but the bottom line. To turn all the lines back on again? 
type Control-E ? then T? then A. 

Remember: T is for Top line of screen; 

the following letter specifies the first line to read. 

Columnar Reading 

A feature that is useful both for skimming and for other 
purposes is columnar reading. One use of this, feature is to read 
a column of numbers in a table. Another is to skim text? for 
instance? by reading only the first twenty characters on each 
line. There are eighty columns on the screen. The leftmost 
column is considered to be column 00 and the rightmost column is 
considered to be column 79. To set which columns are to be read? 
press Control-E? then type the letter 0. Next? type in two two- 
digit numbers? each between 00 and 79. If you make a mistake? 
the computer will tell you and give you a chance to correct it. 

To return to normal reading of the whole screen press Control-E? 
type the letter 0? and press the ENTER key. 

Remember: 0 is for Only certain columns? 

the next 2 digits give the left column? 
the last 2 digits give the right column. 

Count Repeating Punctuation 

A feature of some programs that is useful for sighted 
persons but annoying for blind users is repeating punctuation. 

Dne word processing program? for instance? indicates page breaks 
by putting a row of seventy-nine dashes on the screen. Few 
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people want to hear the synthesizer say '’dash” seventy-nine 
times- This option deals with this problem. 

When Screen-Voice is activated it is in "Some” punctuation 
mode (see explanation above) » where some punctuation characters 
will be pronounced and some will be ignored- In addition* 
Screen-Voice initially does not count repeating punctuation — each 
instance of the punctuation to be spoken will be individually 
pronounced? no matter how often it repeats. 

Pressing Control-E and then G switches to a mode where 
repeating punctuation signs are counted and the count is spoken. 
The user will only hear the count for those characters that the 
current punctuation mode (All? Most or Some) is supposed to 
pronounce. All other characters will continue to be ignored. 
Using this feature in Most or All modes? seventy-nine dashes in a 
row would result in the synthesizer saying the word “dash"? 
followed by the count "seventy-nine"? followed by the word 
"times". To return to saying each instance of the repeating 
punctuation? type Control-E followed by the letter G again. 

Remember: G is for Get rid of repeating punctuation (on or off). 

Stopping Speech 

Often the computer will display a screenful of text? but as 
soon as Screen-Voice starts saying it? the user will realize that 
he does not want to hear it. The zap feature allows the user to 
have the synthesizer stop speaking the text it is preparing to 
say. The effectiveness of the zap feature depends upon the brand 
of synthesizer used -- some cannot be stopped once text has been 



sent to them. The zap command can be entered only if the running 
program is accepting key input. Sometimes, even when a program 
will not take regular key input, it can be stopped by pressing 
Control-C. Then the zap command can be given. To stop speech, 
type Control-E, then Z. In help mode, the computer will send the 
phrase "clear buffer" to the synthesizer immediately after the 
"zap" command; however, this phrase may not be spoken since some 
synthesizer remain inactive for a few moments after receiving a 
" zap " command . 

Remember: Z is for zap the speech buffer. 



Input Modes 

Whenever typing a key causes the corresponding letter, 
number, or symbol to appear on the screen, Screen-Voice will 
immediately read the letter, number, or symbol from the screen, 
without waiting for the end of the line. This is called key 
echoing. Good typists often feel that their time is being wasted 
listening to the synthesizer echo each key. To turn off key 
echo, type Control-E and then K. To turn it on again, type 
Control-E and then K again. 

Remember: K is for Key echo on or off. 



HELP FEATURES 




Reporting Command Key Functions 

There are so many options that it may be hard to remember 
which options have been set or which key affects which options. 
Typing Control-E and then H, will put the computer in a mode 
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where the function of each key is spoken if the key is pressed. 

If the same command key switches a mode on and off? the new 
status will be spoken. To turn off the help messages? type 
Control-E and then H again. 

Remember: H is for Help on or off. 

Position of Video Cursor 

Most programs put a cursor dr small flashing symbol at the 
point on the screen where they expect to receive text. To hear 
the location of this point? press Control-E and then Y. The 
coordinates will be spoken as first a letter corr espond i ng to the 
line on the screen and then a number from 0 to 79 corresponding 
to the column position on the screen. 

Remember: Y is for video cursor position. 

Changing the Command Control Character 

If the word processor or other program you are using 
employs Control-E as a command? you will need to select a 
different control key by using the following procedure. Instead 
of pressing a letter key to choose one of the special features? 
press a different control key (ie. press a different letter key 
while holding down the control key). You may select any key 
except C (because Control-C is used by DOS for escaping from 
programs)? H (because Control-H is Backspace)? M (because 
Control-M is ENTER)? or the key currently being used to start 
screen review? which will be discussed below. In selecting a 
key? avoid control keys that have important functions in software 
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The new control key can then be used to 



you plan to use. 
initiate Screen-Voice output control commands. 

Remember: Control keys change the command control character 
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SCREEN REVIEW FEATURES 



Screen-Voice provides a wide variety of options for 
reviewing what the computer has put on the screen. You may want 
a particular line of the screen replayed because you have 
forgotten what it said. You might have had trouble understanding 
the speech synthesizer and want a few words repeated or spelled 
out . 

The video screen of the IBM Personal Computer has 25 lines 
of 80 characters each. For purposes of screen review? the 
twenty-five lines are called lines A through Y — the first 
twenty-five letters of the alphabet. The character positions are 
called position zero through position seventy-nine. Programs 
running on the IBM personal computer keep track of the location 
where the next character will be written. Usually they indicate 
this location to the user by putting a flashing spot of light on 
the screen. This flashing spot is called the “video cursor." 

When used for screen review? Screen-Voice keeps track of where it 
is reading from the screen. The next location to be read from is 
specified by the "audio cursor." 

Starting Screen Review 

To start screen review? hold down the Control key and press 
the L key. If the word processor? data base system? or other 
program running on the personal computer is accepting key input? 
its operation will be suspended so you can review the screen. 

You may now may select various options and continue reviewing 
until you decide to return to the program you were using. To 
return to that program? press the Escape key. While you are in 
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screen review mode? you do not need to type Control-L before 
selecting each option. Just type the appropriate letters. 

While you are in screen review mode? all of the output 
control modes previously selected are still in effect. If you 
wish to change one of Screen-Voice's output control features from 
within screen review mode? you may press Control-E (or whatever 
control key you have previously selected as the command key) and 
the usual characters needed to change the feature in question. 
Note that in screen review mode? all key presses will be 
interpreted as Screen-Voice commands. No keys will be passed to 
any other program. 

When you enter screen review mode? the audio cursor will be 
set to the same position as the video cursor. If the video 
cursor is outside the boundaries you specified using the column 
or top of screen commands?' however? the audio cursor will be set 
to the upper left corner of the screen window. Screen-Voice will 
notify you of this alternate position. The video cursor will not 
be moved during screen review mode. 

Remember: Control-L initiates screen review? 

Escape ends screen review; 

all output control options are still available. 

Going to a Particular Line 

The lines on the screen are designated by the letters from A 
at the top to Y at the bottom. To go to a particular line? type 
G and then the letter corresponding to the line. 
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Remember: G to Go to a line; 

followed by a letter to specify the line. 

Saying Rest of Line 

To say the rest of the line the audio cursor is on, press 
the ENTER key. When the line has been read, the audio cursor 
will be moved to the start of the same line. Thus you can hear 
the line again by pressing the ENTER key. 

Remember: ENTER to say the rest of the line. 



Moving the Audio Cursor 

You can move up, down, right, or left on the screen by 
pressing the U, D, R, and L keys. If you are in the word-by-word 
mode, pressing the R key will cause the next word or group of one 
or more punctuation symbols to the right to be pronounced, and 
pressing the L key will cause the next word or punctuation group 
to the left to be pronounced. If you are in the 1 e t t er -by- 1 e t t er 
mode, pressing these keys will cause the next letter or character 
to be pronounced. It is usually a good idea to switch into M all 
punctuation pronounced” mode before reviewing to the left or 
right. Otherwise pronunciation of many punctuation symbols and 
of spaces will be suppressed. Pressing the U key will move the 
audio cursor up to the start of the next higher line on the 
screen. Pressing the D key will move the audio cursor down to 
the start of the next lower line on the screen. If you hit the 
right or left end of a line or the top or bottom of the screen, 
the computer will tell you and no harm will be done. When you 
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hit the right end of a line the audio cursor will be repositioned 
automatically to the start of the same line. 

Remember: R is for Right; 



Audio Cursor Position 

You may wish to know exactly where the audio cursor is on 
the screen. (The audio cursor starts in the same place as the 
video cursor when you enter screen review mode, but you may have 
moved the audio cursor.) To have the location of the audio 
cursor spoken press the A key. As usual, the position is given 
by a letter representing the line and a number representing the 
column. 

Remember: A is for Audio cursor. 

Mark a Screen Position and Go Back to it 

You may want to mark a position on the screen so that you 
can go back to it later. Press the M key to mark the current 
audio cursor position. Press the B key to go back to it. The 
marked position will stay the same unless you specifically change 
it. Thus you can mark a position, leave screen review mode and 
do other things. When you come back to screen review mode the 
marker will be at the same place. 



L is for Left 



U is for Up; 



D is for Down 
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Remember : 



M is for Mark; 



B is for Back. 



Finding a String of Characters on the Screen 

To find a string of characters on the screen, type F. Next 
type the string you want to find and press the ENTER key. (Note: 
If the string is over 19 characters long, the twentieth and 
following characters will be ignored. 

At this point, the synthesizer will pronounce the string you 
are looking for. Then it will start at the top of the screen and 
look for the string you want to find. If you have used the 
column or top of screen commands, the search will be limited to 
the screen window you have specified. If Screen-Voice finds the 
string, the synthesizer will say the line of text containing the 
string, and then set the audio cursor to the start of the string 
it has found. If it does not find the string, the synthesizer 
will say "not found" and the position of the audio cursor will be 
unchanged. If you find an instance of the string and want to 
look for another, press the space bar. When you are done 
looking, press any other command key. 

Remember: F to Find a string; 

followed by the string and ENTER; 
space bar to try to find it again. 

Changing the Screen Review Control Character 

If the word processor or other program you are using employs 
Control~L as one of its commands, you will need to select another 
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control key by using the following procedure. Instead of 
pressing a letter key to choose one of the screen review 
features? press a different control key (ie. press a different 
letter key while holding down the control key). You may select 
any key except C? H? M? or the ’key currently being used to start 
output control commands. 

Remember: Control keys change the screen review character. 

End Screen Review Mode 

Finally? you will want to escape from review mode to get 
back to the program you were running. Press the Escape key to 
end screen review. 

Remember: Escape to end screen review. 
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BUILDING A CUSTOM PRONUNCI ATION TABLE 



The synthesizer may make some annoying pronunciation errors 
or there may be words or phrases that the user wants pronounced 
differently for some reason. The custom pronunciation table 
allows the user to use his own pronunciation for any word that 
appears on the screen. We have already given directions for 
activating and deactivating this table. We will now describe its 
structure so that the user may modify it. 

The custom pronunciation table must always be contained in 
an ASCII file called "table". It consists of a series of lines, 
one for each word which will have a custom pr onunc i a t i on . Each 
line must have the following elements in the order listed: 

(1) The word to be specially pronounced; 

(2) One space; 

(3) The string to be substituted (zero to forty-eight characters) 

As an example, many synthesizers pronounce the word " t ypewr i t er “ 
as "type uh writer". The following line in the custom 
pronunciation table will ensure correct pronunciation with most 
synthesizers: 

typewriter type writer 



The treatment of upper case letters when custom 
pronunciation is in effect depends upon whether you are having 
capitals indicated or not. If you are not having capitals 
indicated, custom pronunciation will be provided regardless of 
capitalization. If you are having capitals indicated, the 
situation is more complicated. If only the first letter of a 
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word is capitalized* capitalization will be indicated and the 
custom table substitution will be made. If any other letters of 
a word are capitalized, all capitalized letters will be 
indicated, thus breaking the word into pieces. In this case 
custom substitution will not be made, because it would generally 
interfere with indication of capitalization. 

A sample custom pronunciation table is contained in a file 
called "table" on the Screen-Voice diskette. This table may be 
altered using any word processor that is capable of creating an 
ASCII text file without special word processing control 
characters. (For instance, the "n" option in WordStar works very 
well for editing the custom pronunciation table.) A desperate 
user may use the atrocious Edlin text editor supplied by IBM on 
the DOS disk. There are limits on the size of table entries and 
the table as a whole. In each table entry, the string to be 
substituted may not be over 48 characters long. The total size 
of the table may not be over 800 characters long (counting spaces 
and ends of lines as characters). If the table or an entry in it 
is too long, Screen-Voice will discard the excess characters and 
say a warning message. 
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ADAPTING SCREENREADER TO WORK WITH OTHER SYNTHESIZERS 



The Screen-Voice diskette includes tables of information 
about the characteristics of the following brands of speech 
synthesizer: Echo GP ? Intextalker , Microvox, or Votrax Personal 

Speech System. If you are using one of these synthesizers? you 
need read no further. If you want to use some other brand of 
synthesizer? read on. You may need the aid of someone 
experienced in working with an IBM personal computer? since the 
following description is quite technical. 

If a new brand of speech synthesizer is to be used? a table 
must be created with information about it? and Screen-Voice must 
be reconfigured to use this table. Further adaptation must be 
made if the synthesizer does not meet certain minimum hardware 
requirements . 

The files on the Screen-Voice disk labeled M e.syn"? "i.syn"? 
"m.syn" and "v.syn" contain tables of synthesizer parameters 
needed by Screen-Voice for use with with the Echo GP (e.syn) ? 
Intextalker (i.syn)? Microvox (m.syn)? and Votrax Personal Speech 
System (v.syn). To use Screen-Voice with another synthesizer a 
table must be created for that synthesizer. This table must be 
created as an ASCII file named "n.syn" using a word processor or 
text editor. It may be necessary to enter unprintable ASCII 
characters in the file. These characters must be given their 
equivalent numeric value in the form of a three digit decimal 
(base 10) number preceeded by a star (*)? for instance Control-C 
would be *003. (To put a star itself into the table? use *042? 
the equivalent of the ASCII code for star.) The table must 
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contain the following entries listed below with one entry per 



1 i ne 



First line: the string of characters necessary to initialize the 

synthesizer. (If no initialization is needed, this line must 
just be a RETURN.); 

Second line: the string of characters necessary to make the 

synthesizer pause (for use between words). (If the synthesizer 
lacks this feature, this line must just be a RETURN); 

Third line: the string of characters necessary to make the 

synthesizer stop speaking and throw away any speech data received 
but not yet spoken. (If the synthesizer lacks this feature, this 
line must just be a RETURN.). 

Next twenty-six lines: the strings of characters to be sent to 

the synthesizer to implement Screen-Voice’s 26 rate settings, 
slowest rate first, fastest rate last. (If the synthesizer has 
less than 26 possible rate settings, some of these settings will 
have to be the same; if it has more, 26 settings will have to be 
chosen. ) 

Next twenty-six lines: the strings of characters to be sent to 

the synthesizer to implement Screen-Voice’s 26 volume settings, 
lowest volume first, highest volume last. (If the synthesizer 
has less than 26 possible volume settings, some of these strings 
will have to be the same; if it has more, 26 settings will have 
to be chosen . ) 

Next twenty-six lines: the strings of characters to be sent to 
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the synthesizer to implement Screen-Voice's 26'pitch settings in 
B flat intonation mode, lowest pitch first, highest pitch last. 

■ (If the synthesizer has less than 26 possible pitch settings, 
some of these settings will have to be the same; if it has more, 

■ 26 settings will have to be chosen.) 

■ Next twenty-six lines: the strings of characters to be sent to 

the synthesizer to implement Screen-Voice's 26 pitch settings in 

| inflected intonation mode, lowest pitch first, highest pitch last. 

** (If the synthesizer has less than 26 possible pitch settings, 

^ some of these settings will have to be the same; if it has more, 

I 26 settings will have to be chosen.) 

■ After creating file n.syn, files n.bat and autoexec. n must 
be edited to set the "mode" command each file contains to the 

■ proper parameters for the synthesizer used. File n.bat must be 

m edited to say the name of the synthesizer brand. 

® Once n.syn, n.bat, and autoexec. n are ready, Screen-Voice 

tt must be configured as described earlier in the section of this 

manual on "Installing Screen-Voice Software." To indicate the 
B type of synthesizer, the person doing the configuration must 

f type: 

b : n 

at the point in the procedure for informing Screen-Voice of the 
I type of synthesizer used. 

■ If the speech synthesizer plugs into the serial port (C0M1), 
accepts ordinary English text, is capable of storing at least 256 

a 
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characters of text, and says that text each time a carriage 
return is sent, no further adaptation is necessary. If the 
synthesizer fits in a slot rather than the serial port, or if it 
requires resident tex t-to-speech software or a custom driver 
program, the procedure is much more complex and the assistance of 
a highly skilled IBM Personal Computer Assembler Language 
programmer will be needed. 



This programmer must be able to understand the following 
technical jargon. He or she must write a synthesizer interface 
program as a .COM program to be loaded before Screen-Voice. The 
program must do the following. It must make a copy of the 
Communications Interrupt ( INT 14H) Vector by using DOS Function 
35H . It then must replace the Communications Interrupt (INT 14H) 
Vector with the address of the synthesizer interface program’s 
own output handling routine by using DOS Function Call 25H . It 
then must quit and stay resident by using INT 27H . All 
communications interrupts will thus be sent to the special output 
handling routine. The output handling routine must redirect 
communication meant for ports other than C0M1 to the BIOS 
Communications Interrupt Routine whose address (the Int 14H 
Vector) it has saved. Characters of English text sent by 
Screen-Voice to C0M1 must be intercepted by the output handling 
routine and stored in a buffer. When a carriage return is sent 
out by Screen-Voice, it must be detected and the accumulated text 
must be processed as necessary and then sent to the synthesizer 
to be spoken. The synthesizer interface program is responsible 
for saving and restoring all registers it changes and for 





preserving the integrity of information returned in registers by 
BIOS calls. It must create and maintain its own stack. 



The autoexec. n program must be changed to 
software supplied with the synthesizer and to 
interface program before it runs Screen-Voice. 
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load the resident 
run the synthesizer 



COMMAND SUMMARY 



OUTPUT CONTROL FEATURES 

Before typing each of the following commands, type Control-E 
or whatever Control key you have selected for output control. 



A — All punctuation pronounced. 

B — Spell with Alpha? Bravo? Charlie alphabet. 

C — Custom pronunc i a t ion on/off. 

D — Digits versus numbers. 

E — Enunciation (pauses on/off). 

F — (unused) 

G — Get rid of repeating punctuation on/off. 

H — Help on/off. 

I — Intonation on/off. 

J — Just speak big words (skim). 

K — Key echo on/off. 

L — Letter by letter spelling. 

M — Most punctuation pronounced. 

N — Normal speech. 

□ — Only certain columns (must be followed by two two-digit 
numbers ) . 

P -- Pitch (must be followed by a letter). 

R — Rate (must be followed by a letter). 

S — Some punctuation pronounced. 

T — Top line of screen to be spoken (must be followed by a 
letter ) . 

U — Upper case on/off. 

V — Volume (must be followed by a letter). 
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( unused ) 



X — (unused) 

Y — Video cursor position. 
Z — Zap . 



SCREEN REVIEW COMMANDS 

Type Control-L or whatever Control key you have selected to 
enter screen review mode. When you are done press ESCAPE to 
exit. While in screen review mode? you do not have to type 
Control-L again -- just type the letters listed below. (Notes 
From screen review you can use? in the usual manner? the output 
control features listed above.) 



A — Audio cursor position. 

B -- Back to marked position. 

D — Down one line. 

F — Find (must be followed by typing the string of characters to 
be found and then pressing ENTER.) 

*■. G — Go to line (must be followed by a letter). 

L — Say what is to the left. 

M — Mark a place to return. 

R — Say what is to the right. 

U — - Up one line. 

ENTER — Say rest of line. 

ESCAPE — Leave screen review. 
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SCREEN-VOICE 

Software to Adapt the Apple Personal Computer for Blind Users 

USER’S MANUAL 
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PREFACE 



In 1981 » when we designed the blind user interface for use 
with the Apple Computer and the Echo II speech, the Apple 
Computer had only very limited memory, a maximum of 64K bytes, 
and the Echo II was the only inexpensive speech synthesizer 
available for the Apple. This first blind user interface was 
designed to take a minimum of memory and would work only with the 
Echo II. Minimizing memory meant hand-coding the blind user 
interface in assembly language to squeeze out every last byte. 
Minimizing memory also meant, unfortunately, minimizing the 
features available. Even so, the low cost of the Echo II 
synthesizer, the fact that our blind user interface was supplied 
free with every Echo II, and the ready availabity of Apple 
computers made a talking computer an affordable reality for many 
blind persons. 

In 1985, Apple announced the Apple II RAM Expansion card, 
with deliveries to start in December 1985 or January 1986. The 
RAM expansion card comes with 556 bytes of RAM, but may easily be 
expanded to one megabyte. It contains ROM firmware and bank 
switching hardware to allow it to be used as either a large RAM 
disk or as supplemental bank switched memory. A number of 
companies have started producing excellent synthesizers for the 
Apple, including synthesizers by Micromint, Votrax, and Artie 
incorporating the new SSI-563 (or SCOE) speech synthesis chip. 
Street Electronics has begun marketing a substantially improved 
text to speech program for the Echo II. Digital Equipment 
Company has made the outstanding DECTALK speech synthesizer 



available at reduced prices to educational institutions. (The 
DECTALK may be easily interfaced to the Apple* using the Apple 
Superserial card.) Our new blind user interface has been 
designed to take advantage of the vastly increased memory 
resources and the many brands of synthesizer available. No 
longer is it necessary to restrict the features available in 
order to save memory. Rather* we have attempted to incorporate 
all the features that blind users have indicated that they might 
like added to the limited set of options in the original software 
we designed. Memory availability has also meant that we could 
write our program not in assembly language* which is hard to 
maintain and impossible to transport to other brands of computer* 
but rather in a higher level language (We choose the popular "C" 
language) that makes programs easy to maintain* easy to transport 
to other computers* and easy to adapt to other synthesizers* but 
which does require more memory. 

The blind user interface we have designed will operate on 
existing models of Apple lie computers. However, the memory it 
requires significantly limits the user memory available on a 6^K 
Apple lie; thus most users with only 6^K memory will probably 
want to continue to use our earlier program to save memory. We 
see our program as the program for the Apples of the future with 
their megabyte of RAM each. 

This user’s manual tells how to install the speech 
synthesizer and the Screen-Voice software for the Apple lie 
Personal Computer, and provides instructions for blind users of 
the software. This manual assumes the Apple lie Personal 
Computer is set up and ready to operate. 



Purposes of The Manual 

This manual has five purposes: 

1. To tell you how to set up your computer and speech 
synthesizer for use with the Screen-Voice software. 

S. To guide you in getting the Screen-Voice software working. 
3. To explain the options for reading from the computer screen 
*t. To explain the options for controlling the types of output. 
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INTRODUCTION 



The Screen-Voice software for the Apple lie Personal 
Computer is a program that provides two essential services for 
the blind user. First, it sends to the speech synthesizer a copy 
of everything that appears on the screen, to be spoken as it 
appears on the screen. Second, it allows the user to select 
parts of the contents of the screen for review, replaying 
individual lines, words, or letters. 

SYSTEM REQUIREMENTS 

This software is designed for use with the Apple lie 
Personal Computer with at least memory and the Street 

Electronics Echo Synthesizer. It may be adapted to take 
advantage of Apple II series computers with additional memory, 
for instance the Apple II RAM Expansion Card, and for other 
synthesizers by following the instructions in the Appendix to 
this manua 1 . 
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USING SOFTWARE DEVELOPED FOR SIGHTED USERS 
OF THE APPLE lie PERSONAL COMPUTER 

Many, but by no means all, software programs developed for 
sighted users of the Apple lie Personal Computer can be used with 
Screen-Voice. For instance, blind users can write and run 
programs in the BASIC programming language supplied with the 
Apple Disk Operating System. Many commercially available 
programs will also work. Some, however, will not work. 

u «-> o 



There are three possible types of problems in using 
commercially available programs. First* some commercial programs 
are supplied on diskettes which incorporate special features to 
prevent illegal copying. Some of these programs will incorrectly 
identify an attempt to use Screen-Voice as an attempt to make an 
illegal copy and may refuse to cooperate with Screen-Voice. 
Second* some programs write information directly to the computer 
screen* bypassing the standard Apple lie screen output software 
built into the computer and its operating system. This technique 
gives faster performance for these programs* but makes it 
impossible for Screen-Voice to capture and speak the programs’ 
output. Third* some programs* because they depend heavily on 
graphics or screen location of text* are difficult to describe 
verbally. Thus they are unsuitable for blind users. 

Screen-Voice will work well with software developed 
especially for blind users. This software* for purposes such as 
word processing and data base management* makes use of the power 
of the computer to search for the words that blind users want to 
change or the information they want to get. 

HOW MUCH OF THIS MANUAL DO I NEED TO READ? 

The most essential part of the manual deals with screen 
review and output control features of Screen-Voice. You must 
thoroughly familiarize yourself with these features. However* 
don’t worry about forgetting some of them — you can have the 
computer help you while you are running a program* without 
interfering with the operation of the program. 
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The section on "Adapting Screen-Voice to Work with Other 
Synthesizers is meant for experienced programmers who want to 
alter Screen-Voice to work with other synthesizers. Ordinary 
users can skip this section. 

GETTING STARTED 

We will first list and then explain in detail the steps in 
getting started with your Screen-Voice software. Experienced 
Apple users may read the headings to determine which sections 
they already know. 

SYNTHESIZER PREPARATIONS 

Make sure the Street Electronics Echo Synthesizer is plugged 
into a slot in the computer in accordance with the manufacturer’s 
instructions. Run the demonstration routine provided with the 
synthesizer to make sure it is working correctly. 

PREPARING WORKING COPIES OF SCREEN-VOICE 

Get the Apple DOS 3.3 diskette supplied with your computer. 
Follow the instructions in the DOS Manual to make a copy of the 
Screen-Voice diskette (Use the COPYA program). Put the original 
Screen-Voice diskette in a safe place in case your working copies 

of the program are damaged. Now use the fILEM program on the DOS 

Jt Tet TA'i'KcZ. . l&M .0G3 

diskette to copy the file "TEXTALKER .RAM"^ from the Echo diskette 
to the copy you have just made of the Screen-Voice diskette. 
Finally use the COPYA program to make several working copies of 
the diskette you have just made. Put one of these working copies 
in a safe place as a backup copy. 
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USING SCREEN-VOICE 

Once you have made working copies of your Screen-Voice 
diskette (with "TEXTALKER . RAM" added), using Screen-Voice is very 
simple. All you will need to do is to put a working copy in 
Drive I before turning on the computer. When the computer is 
turned on, the Screen-Voice software will be loaded automatically 
into your computer and the synthesizer will say "Screen-Voice 
ready." You may then replace the working copy of the Screen- 
Voice diskette with one of your program diskettes. If you turn 
the computer off, you will have to put a copy of the Screen-Voice 
diskette in Drive I before you turn it on again. 

OUTPUT CONTROL FEATURES 

When your computer is turned on and Screen-Voice is 
activated, it automatically selects a number of standard or 
"default" features for reading what is sent to the screen. 
However, for special purposes you may want to choose other 
features. This chapter explains the standard features and your 
options for varying them. 

The standard features for Screen-Voice attempt to imitate 

t 

what a sighted person would say if asked to read what was written 
on the screen. The special features allow various types of more 
detailed reading, for tasks such as proofreading. They also 
allow less detailed reading to enable rapid skimming of the text 
on the screen. 
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How to Select an Output Control Feature 

To select an output control feature» hold down the Control 
key, and while holding it down press the E key. This combination 
is called Control-E. The next step is to release these two keys 
and press the command key given below for the feature desired. 

In some cases it will also be necessary to type a number. For 
these commands* upper case and lower case letters have the same 
specified effect. 

An attempt has been made to choose command keys so that the 
letters on the keys are related to the first letters of the names 
of the commands* but this has not always been possible. Single- 
key commands rather than whole-word commands are used because* 
although they are harder to remember* they are much faster to use 
after some practice. One can issue any number of Screen-Voice 
commands in a row and commands may be issued at any time the 
computer is accepting key presses. 

GENERAL PRONUNCIATION FEATURES 

Most speech synthesizers* including the Echo synthesizer, 
allow commands to be sent by the computer to control synthesizer 
pitch, volume, speed, and intonation. Details vary from 
synthesizer to synthesizer. Thus the commands described here for 
varying synthesizer voice characteristics may have different 
effects with different synthesizers. If a particular brand of 
synthesizer lacks certain pronunciation features, the command may 
have no effect, but will do no harm. 
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Intonation 



Most synthesizers allow the user to select either an 
imitation of human speech intonation or robot-like flat speech. 
Some people prefer the flat speech because no synthesizer selling 
for less than $A000 offers good intonation. Others find flat 
speech boring and prefer inaccurate intonation. Screen-Voice 
sets the synthesizer initially to provide intoned speech. To 
switch to flat speech type Control-E and then I. To switch back 
to intoned speech* type Control-E and I again. 

Remember: I is for Intonation on or off. 

Speech Rate 

Most synthesizers allow the user to control the rate of 
speech. Blind persons who are experienced with speech 
synthesizers usually like to run them as fast as possible* so as 
to increase their effective reading speed. However* even 
experienced users sometimes need to slow down the synthesizer for 
difficult passages. To set the synthesizer speech rate* type 
Control-E* then R> and then a letter from A to 2. The letter A 
stands for the slowest rate* the letter 2 for the fastest rate 
and other letters for rates in between. If your synthesizer has 
only one rate* this command will have no effect. If your 
synthesizer* for instance the Echo has only two rates* letters in 
the first half of the alphabet will select the slower rate* and 
letters in the second half of the alphabet will select the faster 
rate. The initial rate is programmed into the synthesizer by its 
manufacturer. For some synthesizers* such as the Intextalker or 
Microvox, changing the rate may also change the pitch. 



Remember 



R is for Rate; 



the following letter selects the rate. 



Vo lume 

Some synthesizers allow users to control speech volume 
through the computer. Others offer a convenient volume control 
knob on the synthesizer. Still others have both options. To set 
the volume through the computer* type Control-E» then V* and then 
a letter from A to 2. If the synthesizer has computer- 
controllable volume* the letter A will produce the softest 
volume* the letter 2 the loudest* and other letters will produce 
intermediate volume levels. If the synthesizer has less than 26 
different levels of controllable volume* letters close together 
in the alphabet may not produce different volumes. On most 
synthesizers* but not the Echo* use of the volume control knob on 
the synthesizer itself is a better way to change volume. The 
initial volume is programmed into the synthesizer by its 
manufacturer . 

Remember: V is for Volume; 

the following letter selects the volume. 



Pitch 

Some synthesizers allow computer control of speech pitch. 

It may lessen fatigue to vary the pitch from time to time so as 
not to listen to the same voice for hours on end. To set the 
pitch control through the computer type Control-E» then P» and 
then a letter from A to 2. If the synthesizer has computer- 
controllable pitch, the letter A will produce the softest pitch, 
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the letter Z the loudest , and other letters will produce 
intermediate pitch levels. If the synthesizer has less than £6 
different levels of controllable pitch» letters close together in 
the alphabet may not produce different pitch levels. The initial 
pitch is programmed into the synthesizer by the synthesizer 
manufacturer. For some synthesi zers » such as the Intextalker or 
Microvox, pitch can also be varied by changing the rate. 

Remember: P is for Pitch; 

the following letter selects the pitch. 



Pauses 

Scientific research shows that it is easier to understand 
speech synthesizers if they are programmed to pause briefly 
between words. However, the pauses slightly slow down the 
reading speed. When Screen-Voice starts running, it does not add 
pauses between words; however there is an option to add pausing. 

To switch between not pausing and pausing, press Control-E, and 
then letter E. To switch back, use the same command. 

Remember: E is for Enunciation on or off. 

FEATURES FOR MORE DETAILED READING 

The usual way of reading text does not bring out all the detail 
necessary for proofreading. The proofreading features of 
Screen-Voice allow the user to have just the amount of extra 
detail he or she wants for the particular task at hand. 



Spelling or Whole Words 

When Screen-Voice is activated it reads by whole words. For 
proofreading it may be necessary to have individual words spelled 
out > since two words may be spelled differently but pronounced 
the same (for instance "t h e i r" and "there"). A word 
could be spelled wrong but pronounced correctly (for instance 
"t h a i r" will be pronounced "there") or spelled correctly but 
pronounced wrong due to a shortcoming of the speech synthesizer. 
To have words spelled out, type Control-E, and then L. To return 
to normal whole word pronunciation press Control-E and then N. 

Some people have trouble understanding a synthesizer when it 
is spelling letter by letter. To have spelling done not with 
letters, but with the "Alpha, Bravo, Charlie" alphabet, press 
Control-E and then type B. 

Remember: L for Letter by letter spelling; 

B is for Alpha, Bravo, Charlie spelling; 

N is for Normal (whole word) pronunciation. 

Capital Letters 

Proofreading may require distinguishing upper case from 
lower case letters. To have upper case letters indicated, press 
Control-E and then U. The computer will then say "cap" before 
each upper case letter. To go back to regular reading, press 
Control-E and then U again. 

Remember: U is for Upper case on or off. 
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Punctuat ion 



In normal reading* special symbols such as and "+" are 

usually read out* but common punctuation marks such as period and 
comma are not pronounced. When Screen-Voice starts* it is in 
normal reading mode. All special symbols and all punctuation on 
the screen are pronounced except the following: dash* period* 

comma* semicolon* exclamation point* question mark* star* double 
quotes* apostrophe* tilde* grave accent* vertical line* 
backslash* left parenthesis* right parenthesis* left bracket* 
right bracket* left brace* and right brace. When reading 
numbers* a decimal point will be pronounced as point. If a 
combination of digits* dollar signs* commas* and periods is 
encountered that is not a well-formed number or monetary amount* 
all characters will be pronounced to alert the user to the 
unusual situation. 

This option is called "Some" punctuation. If you have 
switched to another punctuation option* you can return to "Some" 
punctuation by typing Control-E and then S. 

When proofreading, it is usual to pronounce all punctuation 
but not to indicate spaces. This option is called "Most" 
punctuation. It is available by pressing Control-E and then M. 

Finally, for some purposes it is necessary to know exactly 
what is on the screen* including spaces. This option* called 
"All" punctuation, is available by pressing Control-E and then A. 

None of these modes provides an indication of video cursor 
movement about the screen. Positions of this cursor may be 
checked at any time the computer is accepting input* by using the 
video cursor command described below. 



Remember: S is for Some punctuation; 

M is for Most punctuation; 

A is for All punctuation. 

Numbers 

The reading of numbers also differs in ordinary speech and 
in proofreading. In normal speech* for instance* a three 
followed by a four followed by a five is pronounced "three 
hundred forty five." When proofreading* the same number is 
pronounced digit by digit* as "three four five." When 
Screen-Voice starts* numbers are pronounced in normal speech 
mode* except for combinations of digits* commas* dollars signs 
and periods that constitute neither well-formed numbers nor 
proper monetary amounts. These combinations* such as $3*^.5 are 
spoken character-by-character . To switch between normal speech 
mode and digit-by-digit mode type Control-E and then D. To 
switch back* use the same command. 

Remember: D is for Digits on or off. 

FEATURES FOR LESS DETAILED READING 

The following options allow text to be read faster by 
skipping portions of it. (Remember also that setting the 
synthesizer to a fast speech rate, as explained earlier* will 
speed up reading without loss of any text.) 

Sk immi ng 

Often a user wishes to skim through text to see if it is of 
A skimming option is available that just reads the 




any interest. 



long words in the text» those with seven or more letters. 

Numbers and strings of punctuation and other symbols are skipped 
regardless of length. To just read these big words* type 
Control-E and then J. To return to ordinary reading* type 
Control-E and J again. 

Remember: J is for Just reading long words. 

Ignore Top Lines 

Normally Screen-Voice reads everything that appears on the 
screen. However* some programs continually write status 
information on top line of the screen. This information, such as 
the number of the column currently being written, is of little 
value to the blind user* and is highly annoying when it 
interrupts spoken text. To set the computer to ignore lines at 
the top of the screen, type Control-E, then T, then a letter from 
A to Y. The letter indicates the first line that will be 

pronounced. If the letter is A, the whole screen will be 

pronounced. If the letter is B, pronunciation will start at the 

second line on the screen, if it is C, pronunciation will start 

at the third line on the screen. The letter Y turns off speech 
on all but the bottom line. To turn all the lines back on again, 
type Control-E , then T, then A. 

Remember: T is for Top line of screen; 

the following letter specifies the first line to read. 

Columnar Reading 

A feature that is useful both for skimming and for other 
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purposes is columnar reading. One use of this feature is to read 
a column of numbers in a table. Another is to skim text, for 
instance, by reading only the first twenty characters on each 
line. There are forty columns on the screen. The leftmost 
column is considered to be column 00 and the rightmost column is 
considered to be column 79. To set which columns are to be read, 
press Control-E, then type the letter 0. Next, type in two two- 
digit numbers, each between 00 and 39. If you make a mistake, 
the computer will tell you and give you a chance to correct it. 

To return to normal reading of the whole screen press Control-E, 
type the letter 0, and press the RETURN key. 

Remember: 0 is for Only certain columns; 

the next 2 digits give the left column; 
the last 2 digits give the right column. 

Count Repeating Punctuation 

A feature of some programs that is useful for sighted 
persons but annoying for blind users is repeating punctuation. 

One word processing program, for instance, indicates page breaks 

' by putting a row of seventy-nine dashes on the screen. Few 

people want to hear the synthesizer say "dash" seventy-nine 
times. This option deals with this problem. 

, When Screen-Voice is activated it is in "Some" punctuation 

mode (see explanation above), where some punctuation characters 
will be pronounced and some will be ignored. In addition, 
Screen-Voice initially does not count repeating punctuation — each 
instance of the punctuation to be spoken will be individually 
pronounced, no matter how often it repeats. 
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Pressing Control-E and then G switches to a mode where 
repeating punctuation signs are counted and the count is spoken. 
The user will only hear the count for those characters that the 
current punctuation mode (All, Most or Some) is supposed to 
pronounce. All other characters will continue to be ignored. 
Using this feature in Most or All modes* seventy-nine dashes in a 
row would result in the synthesizer saying the word "dash", 
followed by the count "seventy-nine", followed by the word 
"times". To return to saying each instance of the repeating 
punctuation, type Control-E followed by the letter G again. 

Remember: G is for Get rid of repeating punctuation (on or off). 
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Stopping Speech 

Often the computer will display a screenful of text, but as 
soon as Screen-Voice starts saying it, the user will realize that 
he does not want to hear it. The zap feature allows the user to 
have the synthesizer stop speaking the text it is preparing to 
say. The effectiveness of the zap feature depends upon the brand 
of synthesizer used — some cannot be stopped once text has been 
sent to them. The zap command can be entered only if the running 
program is accepting key input. Sometimes, even when a program 
will not take regular key input, it can be stopped by pressing 
Control-C. Then the zap command can be given. To stop speech, 
type Control-E, then 2. In help mode, the computer will send the 
phrase "clear buffer" to the synthesizer immediately after the 
"zap" command; however, this phrase may not be spoken since some 
synthesizer remain inactive for a few moments after receiving a 
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zap" command 



Remember: Z is for zap the speech buffer. 

Input Modes 

Whenever typing a key causes the cor r espond ing letter? 
number? or symbol to appear on the screen? Screen-Voice will 
immediately read the letter? number? or symbol from the screen? 
without waiting for the end of the line. This is called key 
echoing. Good typists often feel that their time is being wasted 
listening to the synthesizer echo each key. To turn off key 
echo? type Control-E and then K. To turn it on again? type 
Control-E and then K again. 

Remember: K is for Key echo on or off. 

HELP FEATURES 

Reporting Command Key Functions 

There are so many options that it may be hard to remember 
which options have been set or which key affects which options. 
Typing Control-E and then H? will put the computer in a mode 
where the function of each key is spoken if the key is pressed. 

If the same command key switches a mode on and off? the new 
status will be spoken. To turn off the help messages? type 
Control-E and then H again. 

Remember: H is for Help on or off. 

Position of Video Cursor 
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Most programs put a cursor or small flashing symbol at the 
point on the screen where they expect to receive text- To hear 
the location of this point, press Control-E and then Y. The 
coordinates will be spoken as first a letter corresponding to the 
line on the screen and then a number from 0 to 79 corresponding 
to the column position on the screen. 

Remember: Y is for video cursor position. 

Changing the Command Control Character 

If the word processor or other program you are using 
employs Control-E as a command, you will need to select a 
different control key by using the following procedure. Instead 
of pressing a letter key to choose one of the special features, 
press a different control key (ie. press a different letter key 
while holding down the control key). You may select any key 
except C (because Control-C is used by DOS for escaping from 
programs), H (because Control-H is Backspace), M (because 
Control-M is RETURN), or the key currently being used to start 
screen review, which will be discussed below. In selecting a 
key? avoid control keys that have important functions in software 
you plan to use. The new control key can then be used to 
initiate Screen-Voice output control commands. 

Remember: Control keys change the command control character. 



SCREEN REVIEW FEATURES 
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Screen-Voice provides a wide variety of options for 
reviewing what the computer has put on the screen. You may want 
a particular line of the screen replayed because you have 
forgotten what it said. You might have had trouble understanding 
the speech synthesizer and want a few words repeated or spelled 
out. 

The video screen of the Apple lie Personal Computer has £*♦ 
lines of ^0 characters each. For purposes of screen review, the 
twenty-four lines are called lines A through X — the first 
twenty-four letters of the alphabet. The character positions are 
called position zero through position thirty-nine. Programs 
running on the Apple personal computer keep track of the location 
where the next character will be written. Usually they indicate 
this location to the user by putting a flashing spot of light on 
the screen. This flashing spot is called the "video cursor." 

When used for screen review, Screen-Voice keeps track of where it 
is reading from the screen. The next location to be read from is 
specified by the "audio cursor." 

' Starting Screen Review 

To start screen review, hold down the Control key and press 
the L key. If the word processor, data base system, or other 
program running on the personal computer is accepting key input, 
its operation will be suspended so you can review the screen. 

You may now may select various options and continue reviewing 
until you decide to return to the program you were using. To 
return to that program, press the Escape key. While you are in 
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screen review mode, you do not need to type Control-L before 
selecting each option- Just type the appropriate letters. 



While you are in screen review mode, all of the output 
control modes previously selected are still in effect. If you 
wish to change one of Screen-Voice's output control features from 
within screen review mode, you may press Control-E (or whatever 
control key you have previously selected as the command key) and 
the usual characters needed to change the feature in question. 
Note that in screen review mode, all key presses will be 
interpreted as Screen-Voice commands. No keys will be passed to 
any other program. 

When you enter screen review mode, the audio cursor will be 
set to the same position as the video cursor. If the video 
cursor is outside the boundaries you specified using the column 
or top of screen commands, however, the audio cursor will be set 
to the upper left corner of the screen window. Screen-Voice will 
notify you of this alternate position. The video cursor will not 
be moved during screen review mode. 

Remembers Control-L initiates screen review? 



Going to a Particular Line 

The lines on the screen are designated by the letters from A 
at the top to V at the bottom. To go to a particular line, type 
G and then the letter correspond ing to the line. 

Remembers G to Go to a line? 



Escape ends screen review? 



all output control options are still available. 
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followed by a letter to specify the line. 



Saying Rest of Line 

To say the rest of the line the audio cursor is on, press 
the RETURN key. When the line has been read, the audio cursor 
will be moved to the start of the same line. Thus you can hear 
the line again by pressing the RETURN key. 

Remember: RETURN to say the rest of the line. 







Moving the Audio Cursor 

You can move up, down, right, or left on the screen by 
pressing the U, D, R, and L keys. If you are in the word-by-word 
mode, pressing the R key will cause the next word or group of one 
or more punctuation symbols to the right to be pronounced, and 
pressing the L key will cause the next word or punctuation group 
to the left to be pronounced. If you are in the let ter-by-let ter 
mode, pressing these keys will cause the next letter or character 
to be pronounced. It is usually a good idea to switch into "all 
punctuation pronounced" mode before reviewing to the left or 
right. Otherwise pronunciation of many punctuation symbols and 
of spaces will be suppressed. Pressing the U key will move the 
audio cursor up to the start of the next higher line on the 
screen. Pressing the D key will move the audio cursor down to 
the start of the next lower line on the screen. If you hit the 
right or left end of a line or the top or bottom of the screen, 
the computer will tell you and no harm will be done. When you 
hit the right end of a line the audio cursor will be repositioned 
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automatically to the start of the same line 







Remember : 



R is for Right ; 
L is for Left; 

U is for Up; 

D is for Down. 



Audio Cursor Position 

You may wish to know exactly where the audio cursor is on 
the screen. (The audio cursor starts in the same place as the 
video cursor when you enter screen review mode* but you may have 
moved the audio cursor.) To have the location of the audio 
cursor spoken press the A key. As usual > the position is given 
by a letter representing the line and a number representing the 
column. 



Remember: A is for Audio cursor. 



Mark a Screen Position and Go Back to it 



You may want to mark a position on the screen so that you 
can go back to it later. Press the M key to mark the current 
audio cursor position. Press the B key to go back to it. The 
marked position will stay the same unless you specifically change 
it. Thus you can mark a position? leave screen review mode and 
do other things. When you come back to screen review mode the 
marker will be at the same place. 

Remember: M is for Mark; 

B is for Back. 





Finding a String of Characters on the Screen 

To find a string of characters on the screen, type F. Next 
type the string you want to find and press the RETURN key. (Note 
If the string is over 19 characters long, the twentieth and 
following characters will be ignored. 

At this point, the synthesizer will pronounce the string you 
are looking for. Then it will start at the top of the screen and 
look for the string you want to find. If you have used the 
column or top of screen commands, the search will be limited to 
the screen window you have specified. If Screen-Voice finds the 
string, the synthesizer will say the line of text containing the 
string, and then set the audio cursor to the start of the string 
it has found. If it does not find the string, the synthesizer 
will say "not found" and the position of the audio cursor will be 
unchanged. If you find an instance of the string and want to 
look for another, press the space bar. When you are done 
looking, press any other command key. 

Remember: F to Find a string; 

followed by the string and RETURN; 
space bar to try to find it again. 

Changing the Screen Review Control Character 

If the word processor or other program you are using employs 
Control-L as one of its commands, you will need to select another 
control key by using the following procedure. Instead of 
pressing a letter key to choose one of the screen review 
features, press a different control key <ie. press a different 
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letter key while holding down the control key). You may select 
any key except C? H, M? or the key currently being used to start 
output control commands. 

Remember: Control keys change the screen review character. 

End Screen Review Mode 

Finally? you will want to escape from review mode to get 
back to the program you were running. Press the Escape key to 
end screen review. 

Remember: Escape to end screen review. 



ADAPTING SCREEN-VOICE FOR THE APPLE II RAM EXPASION CARD 

The specifications for the Apple II RAM Expansion card have 
not yet been released. It is expected that it will implement a 
"bank select option?" to be activated by accessing certain memory 
locations. The following changes would need to be made in 
Screen-Voice software. (These changes will be simple for any 
experienced Apple mach i ne- 1 anguage programmer to make? 
impossible for anyone else to make.) First? provision should be 
made to load the software (file SV on the diskette) into the RAM 
Expansion card. Second? the short assembler language interface 
program "APY" on the diskette should be altered so that it will 
reside in the RAM Expansion card and connect with file SV there. 
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ADAPTING SCREEN-VOICE TO WORK WITH OTHER SYNTHESIZERS 



The Screen-Voice source code includes a tables of information 
about the characteristics of the Echo speech synthesizer- If you 
are using this synthesizer, you need read no further. If you 
want to use some other brand of synthesizer, read on- The "C" 
source code supplied on should be altered by supplying new values 
for variables *volstr, *ratestr, *fpstr, *ipstr, *initstr, 

*paustr , and *stapstr appropriate to the given synthesizer in 
as described in detail below. File TEXTALKER . RAM should not be 
used — this is the initialization program for the Echo synthesizer 
only. Instead, the initialization program for automatic speaking 
of output directed to the screen should be run for the 
syntehsizer selected. If necessary, changes should be made in 
routine INIT in file APY . 

The "C" program variables should be initialized as follows; 

*initstrs the string of characters necessary to initialize the 
synthesizer. (If no initialization is needed, this string must 
just be a RETURN.); 

♦pausestr : the string of characters necessary to make the 

synthesizer pause (for use between words). (If the synthesizer 
lacks this feature, this string must just be a space); 



*zapstr: the string of characters necessary to make the 

synthesizer stop speaking and throw away any speech data received 
but not yet spoken. (If the synthesizer lacks this feature, this 
line must just be a RETURN.). 
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♦ratestr: the strings of characters to be sent to the 
synthesizer to implement Screen-Voice’s 26 rate settings, slowest 
rate first, fastest rate last. (If the synthesizer has less than 
26 possible rate settings, some of these settings will have to be 
the same; if it has more, 26 settings will have to be chosen.) 

♦volstr: the strings of characters to be sent to the synthesizer 

to implement Screen-Voice’s 26 volume settings, lowest volume 
first, highest volume last. (If the synthesizer has less than 26 
possible volume settings, some of these strings will have to be 
the same; if it has more, 26 settings will have to be chosen.) 

♦fpstr: the strings of characters to be sent to the synthesizer 

to implement Screen-Voice’s 26 pitch settings in flat intonation 
mode, lowest pitch first, highest pitch last. (If the 
synthesizer has less than 26 possible pitch settings, some of 
these settings will have to be the same; if it has more, 26 
settings will have to be chosen.) 

♦ipstr: the strings of characters to be sent to the synthesizer 

to implement Screen-Voice’s 26 pitch settings in inflected 
intonation mode, lowest pitch first, highest pitch last. (If the 
synthesizer has less than 26 possible pitch settings, some of 
these settings will have to be the same; if it has more, 26 
settings will have to be chosen.) 



ERIC 




27 



COMMAND SUMMARY 



OUTPUT CONTROL FEATURES 

Before typing each of the following commands* type Control— E 
or whatever Control key you have selected for output control. 






I 



/ 




A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

P 

R 

S 

T 

U 

V 



All punctuation pronounced. 

Spell with Alpha* Bravo, Charlie alphabet. 

( unused ) 

Digits versus numbers. 

Enunciation (pauses on/off). 

( unused ) 

Get rid of repeating punctuation on/off. 

Help on/off. 

Intonation on/off. 

Just speak big words (skim). 

Key echo on/off. 

Letter by letter spelling. 

Most punctuation pronounced. 

Norma 1 speech . 

Only certain columns (must be followed by two two-digit 
numbers ) . 

Pitch (must be followed by a letter). 

Rate (must be followed by a letter). 

Some punctuation pronounced. 

Top line of screen to be spoken (must be followed by a 
letter ) . 

Upper case on/off. 

Volume (must be followed by a letter). 
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W — (unused) 

X — (unused) 

Y — Video cursor position. 

Z — Zap . 

SCREEN REVIEW COMMANDS 

Type Control-L or whatever Control key you have selected to 
enter screen review mode. When you are done press ESCAPE to 
exit. While in screen review mode» you do not have to type 
Control-L again — just type the letters listed below. (Note: 
From screen review you can use* in the usual manner , the output, 
control features listed above.) ' 

A — Audio cursor position. 

B -- Back to marked position. 

D — Down one line. 

F — Find (must be followed by typing the string of characters to 
be found and then pressing RETURN.) 

G — Go to line (must be followed by a letter). 

L -- Say what is to the left. 

M — Mark a place to return. 

R — Say what is to the right. 

U — Up one line. { 

RETURN -- Say rest of line. 

ESCAPE — Leave screen review. 
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PREFACE 



This user’s manual tells how to the Screen-Voice software 
for the TRS-80 Model 100 Portable Computer and provides 
instructions for blind users of the software. This manual 
assumes the TRS-80 Model 100 Portable Computer is set up and 
ready to operate* and that the speech synthesizer has been 
connected to the computer in accordance with the instructions 
supplied with the synthesizer. 

INTRODUCTION 

The Screen-Voice software for the TRS-80 Model 100 Portable 
Computer is a program that provides four essential services for 
the blind user. First» it sends to the speech synthesizer a copy 
of everything that appears on the screen* to be spoken as it 
appears on the screen. Second* it allows the user to select 
whether text should be spoken as words or spelled. Third* it 
allows the user to control what punctuation will be spoken. 
Fourth* it provides a notetaking and review system. 

THE COMPUTER AND THE SYNTHESIZER 



THE COMPUTER 

This software is designed to function with the Radio Shack 
TRS-80 Model 100 Portable Computer. Unless you have considerable 
computer expertise* you should buy a new computer from a local 
authorized Radio Shack Dealer so that you can get qualified help 
in setting up the computer and warranty repairs if necessary. If 



you do have computer expertise* you may be able to save money by 
ordering a computer by mail or by buying a second-hand computer. 

To be used with this program* the TRS-80 Portable Computer 
must have 32K of RAM memory. (Any Radio Shack dealer will be 
happy to sell and install additional memory if your computer 
comes with less than 32K of RAM.) 



THE SPEECH SYNTHESIZER 



This software requires a special speech synthesizer for the 
TRS-80 Model 100. You should follow the instructions supplied 
with the synthesizer to install it. 

MAKING WORKING COPIES OF THE SCREEN-VOICE SOFTWARE 
Before configuring the Screen-Voice software you should make 
several working copies of it. Screen-Voice is supplied on two 
cassettes. One contains a copy of a program called TALK* the 
other contains a program called NOTE. 

To make copies of TALK* place the TALK casette in the 
cassette recorder* ready the recorder* select BASIC from the 
menu, then type: 



CLEAR A5000 * 256 <ENTER> 

LOADM "TALK" 

When SCREEN is successfully loaded insert and rewind a blank data 

cassette in the recorder and type: 

/■£ 

SAVEM "TALK" , A50©€>, fXlft ( 

To make an additional backup copy, once again insert and rewind a 
blank data cassette in the recorder and type: 

SAVEM "TALK" ,A50GO, 
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To make copies of NOTE? place the NOTE casette in the 
cassette recorder? ready the recorder? select BASIC from the 
menu? then type: 

LOAD "NOTE" 

When NOTE is successfully loaded insert and rewind a blank data 
cassette in the recorder and type: 

SAVE "NOTE" 

To make an additional backup copy? once again insert and rewind a 
blank data cassette in the recorder and type: 

SAVE "NOTE" 

USING SCREEN-VOICE 

TALKING BASIC SYSTEM 

Program TALK? the Talking Basic System is designed to allow 
you to run programs written in BASIC and to write programs in 
BASIC. To activate the Talking BASIC System type: 

CLEAR **5000 ? 256 

and then? being sure that the diskette with the TALK program is 
ready in your cassette recorder? type: 

RUNM "TALK" 

At this point Talking BASIC is loaded? but not activated. To 
activate it type: 

CALL **5059 

(You may deactivate the Talking BASIC at any time by typing: 

CALL **5062 

O 
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You may then reactivate it at any time by typing: 

CALL ^5059 

Warning — you must deactivate Talking BASIC before leaving BASIC 
to go to the main menu or options on the main menu will not work. 
If you accidently exit to the main menu, with Talking BASIC still 
active, you must restart the computer by turning off the master 
power switch on the bottom of the computer, removing any 110 volt 
adapter, waiting a minute, and then turning the computer on 
again. 

SPEECH OPTIONS 

The standard features for Talking BASIC attempt to imitate 
what a sighted person would say if asked to read what was being 
written on the screen. 

Spelling or Whole Words 

When Talking BASIC is activated it reads by whole words. 

For proofreading it may be necessary to have individual words 
spelled out, since two words may be spelled differently but 
pronounced the same (for instance "t h e i r " and "t h e r e" ) . 

A word could be spelled wrong but pronounced correctly (for 
instance "t h a i r M will be pronounced "there" ) or spelled 
correctly but pronounced wrong due to a shortcoming of the speech 
synthesizer. To have words spelled out, type CALL ^5065. To 
return to normal whole word pronunciation press type CALL ^5068. 

Remember: CALL ^5065 for letter by letter spelling, 

CALL ^5068 for whole word pronunciation. 



Pune tuat ion 



In normal reading? special symbols such as and "+" are 

usually read out? but common punctuation marks such as period and 
comma are not pronounced. When Screen-Voice starts? it is in 
normal reading mode. All special symbols and all punctuation on 
the screen are pronounced except the following: dash? period? 

1 comma? semicolon? exclamation point? question mark? star? double 

quotes? apostrophe? tilde? grave accent? vertical line? 
backslash? left parenthesis? right parenthesis? left bracket? 
right bracket? left brace? and right brace. When reading 
numbers? a decimal point will be pronounced as point. If a 
combination of digits? dollar signs? commas? and periods is 
encountered that is not a well-formed number or monetary amount? 
all characters will be pronounced to alert the user to the 
unusual situation. 

This option is called "Some" punctuation. If you have 
switched to another punctuation option? you can return to "Some" 
punctuation by typing CALL ^507^t . 

When proofreading? it is usual to pronounce all punctuation 
but not to indicate spaces. This option is called "Most" 
punctuation. It is available by typing CALL ^t5077. 

Finally? for some purposes it is necessary to know exactly 
what is on the screen? including spaces. This option? called 
"All" punctuation? is available by typing CALL ^5071. 

Remember: CALL ^507^ is for some punctuation; 

CALL ^5077 is for most punctuation; 

CALL ^5071 is for all punctuation. 

ERiC 
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NOTE-TAKING AND REVIEW SYSTEM 



The Note-taking and review system is a program in BASIC that 

lets you take notes, read the notes back, and transfer the notes 

to another computer. To activate this system, first activate 
Talking Basic. Then put the cassette with program NOTE in the 
recorder and type: 

RUN "NOTE" 

When program NOTE is running, anything typed on the keyboard will 

be saved in a large, 8000 character storage area in memory. If 

this area becomes full, the computer will beep every time you try 
to type something. 

You have a number of options while running program the 
Notaking and Review System. Each option is selected by pressing 
one of the function keys under the screen. The options are as 
fo 1 lows : 

Function Key 1 

Pressing this key sends the entire file out the serial port. 
The serial port should be connected to the receiving computer 
through a "modem eliminator." The receiving computer should be 
set to receive a text file at 300 baud, with even or ignored 
parity bit, one stop bite, and no X-on, X-off protocol. A 
shareware program, such as PC-TALK for the IBM PC, is ideal for 
this purpose. 




Function Key 2 

Pressing this key saves the entire file on a cassette with 
the name "NOTES". 
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Function Key 3 

Pressing this key reads a text file named "NOTES" from 
cassette . 

Function Key 4 

Reserved for future expansion. 

Function Key 5 

Reserved for future expansion. 

Function Key 6 

Reserved for future expansion. 

Func t ion key 7 

Speaks out entire contents of note file. 

Function key 8 

Erases entire note file. To prevent accidental erasure, this 
key beeps when pressed. Then if you really want to erase the 
file, press "Y". Otherwise press any other key and the file will 
remain unharmed. 

Altering the Notetaking and Review System 

Since the system is written in ordinary BASIC, you (or a 
friend who is used to programming in BASIC) can easily alter it 
to add any features you want. 
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PREFACE 



Talkhelper is a program designed to allow non-speaking 
persons to use a personal computer with a speech synthesizer as a 
substitute voice. Many non-speaking persons have other physical 
or mental handicaps. Talkhelper offers flexibility in selection 
of input devices and screen displays so that it may be customized 
for each user to make maximum use of his or her abilities and to 
compensate for his or her disabilities. 

This manual is for use with Talkhelper for the IBM Personal 
Computer. (Other versions of Talkhelper are available for the 
Apple lie personal computer and the Radio Shack Model 100 
portable computer.) 

PURPOSES OF THIS MANUAL 

This manual has four purposes: 

1. To tell you how to set up the computer? speech 
synthesizer? and input device for use with the Talkhelper 
sof twar e ; 

2. To help you configure the Talkhelper software for the 
computer? synthesizer? input device? and options you want; 

3. To explain how to create and edit screen menus? 

To explain how to use Talkhelper as a speech aid. 

DO I HAVE TO READ ALL OF THIS MANUAL? 

If you are planning to install the speech synthesizer? input 
devices and Talkhelper yourself? you should study the sections of 
this manual on installation before you try to install the 
synthesizer? input devices? and Talkhelper. If someone else has 
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installed the synthesizer, input devices, and Talkhelper for you, 
you can ignore these sections of the manual. 

Unless you intend to use a brand of synthesizer other than 
one of those listed below, you can ignore the section of the 
manual on adapting Textalker for use with other synthesizers. 

All of the rest of the manual is important, regardless of 
what synthesizer you use and regardless of who installs it. 
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SELECTION OF COMPUTER, SPEECH SYNTHESIZER, AND INPUT DEVICES 



COMPUTER SELECTION 

This software is designed to function with the IBM Personal 
Computer. Unless you have considerable computer expertise, you, 
should buy a new computer from a local authorized IBM Dealer so 
that you can get qualified help in setting up the computer and 
warranty repairs if necessary. If you do have computer 
expertise, you may be able to save money by ordering a computer 
by mail or by buying a second-hand computer. 

All models of the IBM Personal Computer come equipped with 
the diskette drive and memory needed for this program. If you 
plan to use picture menus, the computer must have the IBM 
Color /Graphics Monitor Adapter. (A color monitor is desirable, 
but not necessary for picture menu displays — you can use a 
black and white, green screen, or amber screen monitor with 
picture menus. 

SPEECH SYNTHESISER SELECTION 

Any of the following synthesizers may be used with the IBM 
Personal Computer: Echo GP , Intextalker , Microvox, Votrax Persona 

Speech System. 

The speech quality of all these synthesizers is about equal. 
However, you may have a personal preference, so listen to several 
before buying. None of these synthesizers provides truly high 
quality speech — for high quality speech the best choice is 
the very, very expensive Dectalk synthesizer from Digitial 
Equ i pment Company . 
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INPUT DEVICE SELECTION 



Some persons with speech handicaps can use the computer 
keyboard very well. However, since many persons with speech 
handicaps also have other disabilities which prevent them from 
typing on the regular computer keyboard, Talkhelper allows the 
use of different input devices so that each user can use the form 
of input best adapted to his or her disabilities. 

The possible devices are: the regular IBM Personal Computer 

keyboard or special switches connected to the hand control 
connector on the computer. The following discussion is meant to 
help you choose an input device. Often it is obvious which 
device should be used. Sometimes it is difficult to determine 
which device is best, and it may be necessary to try several 
types of input device and to seek the advice of an appropriate 
health care or education pr of ess iona 1 . Some users may be able to 
advance to more complex input devices that provide faster control 
of the computer. The discussion below will consider factors in 
choice of input devices for users with speech disabilities 
only, or those with speech disabilities and with poor motor 
control, poor vision, poor or no reading ability, or poor memory. 
The various possible types of input device and the ways in which 
the can be used will be considered in turn. 

COMPUTER KEYBOARD INPUT 

The computer keyboard has two great advantages and two great 
d i sad van t ages . The two great advantages are that a keyboard 



comes at no extra charge with every IBM Personal Computer and 
that a good typist can enter any English phrase at high speed 
using the keyboard. The two great d i sad van t ages are that the 
keyboard is hard to use for persons with physical disabilities 
and hard to understand for persons with cognitive disabilities. 
Talkhelper offers several ways to use the keyboard to allow 
customization for different types of users. 

Eyll Keyboar d Input 

Full keyboard input is ideal for a person with speech 
disabilities, but no other disabilities. With a relatively small 
investment of time such a person should be able to learn typing, 
a skill with many appl icat ions, and should be able to reach a 
typing speed of over 50 words a minute. Such a person will be 
able to use Talkhelper to say anything he or she wants at a speed 
of at least 50 words a minute, as compared to a normal speech 
rate of 80 to 100 words a minute. 



Full keyboard input may also be possible for a person with a 
moderate level of physical disability. The disability may reduce 
the accuracy with which keys are pressed, the speed with which 
they can be reached, or may prevent use of the shift key. Even 
with these problems, it may be possible to get satisfactory 
results from Talkhelper. Often accuracy can be improved 
substant i a 1 1 y by the use of a keyguard or an oversized keyboard. 
(These are available from companies supplying computer products 
for handicapped users.) If the disability subs tant i a 1 1 y reduces 
the speed with which keys can be selected, the user will probably 
wish to supplment typed text with phrase selection input (see the 
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section below entitled “Phrase Selection" ) 



Restricted Keyboard ingut 

Users with poor accuracy, limited reach, or inability to 
understand the complexities of a full typewriter keyboard may 
benefit from an option of Talkhelper that allows the assigning of 
the whole keyboard to be treated as a single switch or of the 
spacebar and the rest of the keyboard each to be considered as a 
sw itch, 

SWITCH INPUT 

Switch input also has advantages and disadvantages. The 
advantages of switches are that they are easy to buy and attach 
to the computer and that they can be used by persons with 
physical handicaps that prevent pressing keys on the computer 
keyboard. One disadvantage is that input is much slower than 
with full keyboard typing. Another disadvantage is the 
difficulty users with limited cognitive ability may have in 
associating closing switches with what is happening on the 
screen . 

Talkhelper can be configured to work with either one or two 
switches. The two-switch input mode offers better control and 
faster input than the one-switch mode. Therefore it is the 
preferred mode for persons who can operate more than one switch. 
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SETTING THE SPEECH SYNTHESIZER SWITCHES AND CONTROLS 



Speech synthesizers have switch settings which must be made 
before the synthesizer is ready to use. The synthesizer switches 
should be set as follows: 

Echo GP: 

The switches are located on the bottom of the synthesizer 
near the middle of the back. (The back is the side where the 
wires come out.) There is a square hole in the back of the 
synthesizer, and in this hole are four tiny switches. The part 
of each switch toward the back of the synthesizer should be 
pushed inward. This will set the synthesizer for 9600 baud. 

Intextalker and Microvox: 

The hardware of these two synthesizers is identical. The 
switches are located inside the synthesizer. Make sure the 
synthesizer is unplugged from the electric power line before 
attempting to change the switches! The first step is to turn the 
synthesizer upside down and remove the two long screws that hold 
the top on. One screw is located in the middle of the right and 
the left side of the bottom of the computer, just inside the 
edge. You will need a Phillips screwdriver to remove the screws. 
After removing the screws, turn the synthesizer right side up, 
and place it with side with the volume control knob facing you. 
There are two sets of eight switches that will have to be set. 

The first set is located half-way between the right and left 
edges of the circuit board, about one inch back from the front of 
the board. Switch number 4, which is the fourth switch from the 
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rear of the board on this set of switches, should be pushed to 
the right.; and the other switches should be pushed to the left. 
This will set the communications rate to 1200 baud. The second 
set of switches is located very near the right hand edge of the 
board, about three inches back from the front of the board. On 
this set of switches, Switches 1, 2, and 8 (the first, second and 

eighth switches from the rear of the board) should be set to the 
right, and the others should be set to the left. This will 
provide for hardware handshaking. If you have the Intex upgrade 
for improved pr onunc i a t i on , switch settings may be different, as 
described in the instructions that come with this upgrade. 

Votrax Personal Speech System: 

Turn the synthesizer so the volume control is away from you. 
On the part of the synthesizer that is now toward you, about 
three inches leftward from the right side is an oblong hole, 
about a third of an inch high and an inch wide. A set of eight 
switches can be reached through this hole. The switches should 
all be pushed down, except switch 6 (the sixth from the left), 
which should be pushed up. This will set the synthesizer to 9600 
baud, RTS serial port communication, 7-bit word with ignored 
parity bit, power-up message spoken, serial port used as primary 
input port, and self-test off. 
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INSTALLING THE SPEECH SYNTHESIZER 



I 

1 

The synthesizer will have to be attached by cable to the 

■ cable to the C0MM1 serial port on the IBM Personal Computer. If 

H' possible? you should buy the necessary cable from the synthesizer 

manufacturer. If this is not possible? you should be prepared to 
H pay up to $100 to have a local computer store make a cable from 

the instructions in the IBM and synthesizer manuals. If the 
manufacturer provides a demonstration diskette? it should be used 

■ to test the speech synthesizer once it is installed. Users with 
physical disabilities will find it very convenient to plug the 

■ computer? speech synthesizer (if it has a separate plug)? and the 

™ w 

^ video monitor into a single power strip so that they may all be 

** turned on with one switch. 
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INSTALLING THE INPUT DEVICES 





Keyboard 

The keyboard comes with the IBM computer j so no special 
purchase or installation is necessary if you plan to use the 
standard keyboard as the only input device- If a user cannot use 
the standard keyboard, because of poor motor control, he may be 
able to use the keyboard with a metal keyguard (These are 
available from companies supplying aids for the handc i apped - ) 



Switches 

Talkhelper may be used with either one or two switches. Two 
switches allow much better control and faster communication than 
one switch. The switches should be attached to an IBM game 
control adapter card plugged into the IBM computer. Switches, 
the necessary connectors, and installation instructions are 
available from companies specializing in devices for the 
physically handicapped. 
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CONFIGURING THE TALKHELPER SOFTWARE 



Before configuring the Talkhelper software you should make 
several working copies of it. To make a working copies follow 
the instructions in the IBM DOS manual for copying a disks with 
the DISKCOPY command. Then put the original Talkhelper disk and 
one working copy in a safe place to use in case your other copies 
are damaged or wear out. Now you are ready to configure the 
working copy for a particular hardware configuration and a 
particular user. If different persons will be using Talkhelper, 
for instance various students in a special education classroom, a 
separate working copy of the disk will be have to be configured 
to meet the needs of each student. Configuration consists of 
indicating the kind of synthesizer that will be used. 

If you have two floppy diskette drives, leave put a DOS 
diskette in drive A and insert the Talkhelper diskette into drive 
B. Type "b: " followed by the first letter of the name of your 
synthesizer. For Intextalker , type " i " ; for Microvox, type "m"; 
for Echo GP , type M e M 5 for Votrax Personal Speech System, type 
"v" . 

If you have only one floppy diskette drive (with or without 
a hard disk drive), insert a DOS diskette inserted and type "b:" 
followed by the letter cor r espond i ng to your synthesizer as given 
above. Since the installation program needs to copy some DOS 
files onto your Talkhelper diskette, you will need to switch 
diskettes and press return each time the diskette drive stops, 
until the the computer prints M A>" to show that configuration is 
done . 
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DESIGNING SCREEN DISPLAYS 



Once the computer has been configured for type of 
synthesizer, type of pr onuc i a t i on , and input mode, it is 
necessary to design what will be displayed on the screen and what 
will be output from the computer to the speech synthesizer. The 
following discussion will first discuss the theory behind the 
various options for screen display for speech-hand i capped 
persons, and their advantages and d i sad van t ages , and then will 
indicate exactly how to design Talkhelper screen displays. 

THEORY OF SCREEN DISPLAY 

Screen display serves five purposes. First, it can present 
a list of alternatives to prompt the user who is unable to 
remember the effect of a complex set of keypresses or switch 
closures. Second, it can provide feedback on input errors, so 
that the user can correct them before a phrase is spoken. Third, 
it can enable users of stepping or scanning modes to coordinate 
their input actions with the stepping or scanning. Fourth, it 
can provide information to a person helping or training a user on 
what the user is trying to do. Fifth, it can provide necessary 
feedback and information during the process of selecting 
alternatives and editing menu selections. 

The Screen Display as an A i_d to Memory 

The screen display aids the user who cannot remember the 
effects of various keypresses. This use of the screen display 
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can be compared to the function of the menu in the typical 
Chinese restaurant in the United States. Usually this menu will 
contain a list of dishes, each with a number and a short name, 
e.g. Mi 4. Sweet and Sour Pork.'* The customer can tell the waiter 
the numbers for the selections he wants and soon a delicious 
Chinese meal will be served. There are really three aspects to 
this menu. The name of the dish on the menu (“Sweet and Sour 
Pork' 1 ) serves as a short description to remind the American 
customer of what dishes are available. The number serves as a 
means of communication with the Chinese waiter (who may not 
understand English). The waiter then may yell the order back to 
the kitchen in Chinese, “Please prepare one order of Sweet and 
Sour Pork." Similarly the screen display system of Talkhelper 
has three parts. Each item on the screen has three parts: (1) 

a designator — a letter or a number that serves the same 
function as the number next to the name of the dish on the 
Chinese restaurant menu; (2) a label — a word or phrase that 
serves the function of the name of the dish on the Chinese 
restaurant menu; (3) in the computer memory, but not normally 
appearing on the screen, the actual action that selecting the 
particular designator will cause the computer to make, 
cor respond i ng to the action that will result from a request to a 
waiter in the restaurant. 

Take the following example. There may be an entry on the 
screen that appears as follows: 

W. Water 

When the user presses the designator "W“ that is next to the 
label "Water”, the the action the computer will take is to say 
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the correspond ing phrase that has been previously entered, e.g., 
“I’m thirsty, please get me a glass of water." 

The menu is necessary in a Chinese restaurant because most 
people cannot remember the huge variety of dishes in the Chinese 
cuisine, and because it provides a simple and fast method of 
communication even if the waiter does not understand English.. 
Likewise, once a computer is programmed to say a large number of 
phrases, a menu may be necessary to help the user remember all 
the phrases and to provide a fast and simple means of 
communication with the computer, which, like many foreign 
waiters, does not understand English. However one menu or one 
screen display may not be enough. In a restaurant, the menu 
might get too big if the owner tried to put everything on it. So 
the menu may say, “Please ask if you want to see the banquet 
menu, the cocktail menu, or the children’s menu." Customers may 
then obtain these menus from the waiter. The need for such 
supplemental “menus" or displays is far greater on the computer, 
since a single screen display can hold much less information than 
a typical restaurant menu. Thus one of the actions the user must 
be able to command from the computer is to display additional 
screens of information with additional options. 

Usually in a restaurant a patron will want to order a whole 
meal at once. Likewise someone using a computer as a speech aid 
may want to make a whole series of statements at once. Thus a 
mechanism is needed to allow the computer to save up several 
statements and say them all at once. 
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Screen feedback on Ingut Errors 

Whether a user is typing in words to be spoken? or using a 
screen designator and label system to select phrases? the user 
will undoubtedly make some errors. The screen display must show 
what words are typed or what phrases are selected so the user can 
see any errors and then must show corrections as they are made. 

QoQL^Ina t Ion Qf Input Actions with Item Selection 
ID Scanning and Stepping Modes 

In scanning and stepping modes? the screen display provides 
coordination of user input actions with selection of items. For 
instance? in a single switch system? a cursor or spot of light 
may move from item to item on the screen. The user needs the 
information on the screen to be able to close the switch at the 
right time to select a particular phrase. In stepping mode? the 
user closes one switch to step the cursor from item to item and 
then presses a different switch to select a phrase. Here again? 
screen feedback is needed to allow the user to see which phrase 
is currently indicated by the cursor. 

lofo L[Q§f for the Person Helping or Training the User 

Some users may need considerable help in learning to use 
Talkhelper. The screen display will enable persons helping users 
to see exactly what the user is doing? and thus to provide the 
necessar y assistance. 

HOW TO USE TALKHELPER 
The Sample Programs 
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There are sample text and picture menu programs on the 
Talkhelper Diskette called sample. You should read these 
instructions through and then work for a while with the programs 
called text and picture before you try to create your own set of 
menus. To run the text menu program, just type ’’text” and press 
the ENTER key. To run the picture menu program, just type 
’‘picture" and press the ENTER key. 

After you have practiced with these programs, you will be 
ready to create and edit menus for a particular user. 

Every user will have different needs in terms of what the 
user wants to say and the type of labels the user needs as memory 
aids in order to be able to make selections. Talkhelper is not 
based upon any preconceived model of what the user should want to 
say or how much memory assistance the user needs. Rather it is 
left to the user or someone helping the user to create memory 
aids and phrases to be spoken that are appropriate to the 
particular user. 

Each menu has a sets of what we will call labels, 
designators, and associated phrases or actions. When a text menu 
is displayed on the screen, the display will look something like 
the following (actually there will usually be more entries): 
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HONE 



A. Open Door 

B. Close Door 

C . Upstair s 



D. Open Window 

E . Close Window 

F. Downstairs 



The word "HONE" at the top of the screen is the name of the menu. 
We call the letters A, B» C, D, E, F designators. They are used 
for selection of particular menu entries. The short text items* 
"Open Door*" "Close Door' 1 * etc.* are called labels. They serve 
to remind the user of what will happen if a particular entry is 
selected. Finally, associated with each entry is a phrase or 
action that is not ordinarily visible on the screen. Thus for 
instance, assocated with "A. Open Door" may be the phrase, 

"Please open the door." Associated with "C. Downstairs" may be 
the action command ^DOWNSTAIRS* which instructs the computer to 
display a different menu called "DOWNSTAIRS" if entry "C" is 
selected . 

The editing process allows creation of new menus, the 
changing of old menus, and setting of various items affecting all 
the menus. 

Picture menus are exactly like text menus, except that a 
picture is associated with each picture menu and the picture is 
normally displayed whenever the menu is accessed. To edit 
a picture menu, hold down the control key and press "E" (this is 
called typing "Control-E" ) . The text menu with which picture is 
associated will then appear on the screen for editing. To go 
back to the picture, hold down the control key and press "R" 

(this is called typing "Control~R" ) . The picture will again be 
d i sp 1 ayed . 
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Menu Ogerat ions 

The user may also wish to take actions affecting the menus 
as a whole or a particular menu. To take such actions, press the 
slash ("/") key and a list of alternatives will appear on the 
screen. The alternatives are: adding a menu, deleting a menu, 

editing a menu entry, input mode selection, number of entries 
selection, renaming a menu, scanning speed selection, writing out 
all menus, doing nothing. Each of these will be discussed in 
turn . 

Adding a Menu 

New menus may be added. However there may not be more than 
a total of 35 menus. To add a menu, first press slash ( " / " ) and 
then the letter "a" or "A" (capital or small letters always have 
the same effect). The computer will then ask for the name of the 
new menu. If there is some problem, for instance if a menu with 
the same name already exists, an appropriate message will appear 
on the screen. If there is no problem, you will be asked the 
number of entries you want in the menu. 

Before trying to display a picture menu, you must have put 
on the diskette a file containing a picture. The file must have 
the same name as that you plan to give to the picture menu. 
Details of how to create the picture file will be discussed below 
under "Picture Creation." 

Deleting a Menu 

A menu may no longer be needed. To get rid of a menu, press 
first slash ("/") and then the letter "d". Instructions for 
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deleting a menu will appear on the screen. 



If there is an error, 



for instance an attempt to delete a menu that does not exist, or 
an attempt to delete the menu called MAIN, which cannot be 
deleted, an appropriate message will appear on the screen. There 
always must be a menu named "MAIN*', which will be the first menu 
to appear on the screen when the program is run. If you want to 

delete the current "MAIN 11 menu, the program will ask you for the 

name of some other menu to take its place. WARNING! ! ! ! ! ! If a 
menu is deleted it is gone. Be careful about deleting a menu. 

If you delete a menu by mistake, no harm is done as long as you 

do not write out the menus to the diskette, provided that the 

menu deleted was on the diskette when you turned on the computer. 
Just take out the diskette and turn off the computer and all the 
changes made will be forgotten. To be safe, before editing 
manus, make backup copies of diskettes containing important 
menus . 

Editing a Menu Entry 

To enter or change a label and the cor respond ing phrase or 
action the user should press slash ( " / " ) and then "e". (As a 
shortcut, the user can press period This has the same 

effect as pressing slash and then “e”.) Then the user should 
select the designator for which the user wishes to supply 
information. The user will then be asked for a label to appear 
after the designator and for a phrase or action to be selected 
when the designator is pressed. The label can be up to 30 
characters long. The phrase can be as short as a single letter 
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or number or as long as 75 characters. A user capable of 
typing on a regular keyboard should enter the phrase or action 
just by typing and then pressing the ENTER key. A special 
scanning and stepping entry mode (described below) is available 
for uses who cannot use a regular keyboard. 

In addition to generating a phrase to be spoken? an entry 
can be used to command the computer to take the action of 
plotting another menu on the screen. This is done by typing as 
the desired action an asterisk ( M * n ) followed by the name of the 
menu to be put on the screen. Thus if the user wanted the result 
of pressing M to be to put the menu called MATH on the screen the 
user would type: *MATH as the action to be taken. 

Text menus for use in scanning and stepping modes should be 
set up with the following five entries as the first three 
entries? since the user will not be able to select the necessary 
special keys by directly typing on the keyboard: 

A. ENTER (the cor r espond ing text should be "CENTER" ) 

B. ESCAPE (the cor respond ing text should be "8* 1 ESCAPE “ ) 

C. BACKSPACE (the cor r espond i ng text should be " ^BACKSPACE “ ) 

D. SLASH (the cor respond ing text should be "&/") 

E. PERIOD (the cor respond ing text should be M &.") 

Input Mode Selection 

The system provides 5 basic and 5 supplemental input modes. 
The basic input modes are: (1) normal keyboard input; (2) 

scanned input using the keyboard as a switch; (3) scanned input 
using a switch attached to a game control adapter card; (^> 
stepped input using the space key as one switch and the other 



keys as a second switch; 



(5) stepped input using two switches 



attached to a game control adapter card. The supplemental input 
modes all use a list of letters and charaters displayed on the 
screen. They vary by method of selection: (1) normal keyboard 

typing; (2) scanned input with the keyboard as a switch; (3) 
scanned input using a single switch attached to a game control 
adapter card; (^-) stepped input with the space bar as one switch 
and the other keys as a second switch; (5) stepped input using 
two switches attached to a game control adapter card. 

The basic input modes are used to make selections from a 
menu. The supplemental mode is used to allow a handicapped user 
to type in entries to edit menus and select program features. 

To select an input mode for a menu, type slash < " / " ) and then "i" 
and follow the instructions that appear on the screen. The 
supplemental mode for the menu will be set to correspond to the 
basic mode. Thus, for instance, if scanned input is selected for 
a menu, supplemental input will be by scanning a list of 
characters displayed on the screen. 



Renaming a Menu 

You may want to change the name of a menu. For instance you 
might want to change the name of the menu called "PHYSICS" to 
"SCIENCE". Press slash <"/" ) and then press "r M and follow the 
instructions to rename the menu. Since there must always be a 
menu named "MAIN," if you try to rename "MAIN," you will be asked 
for the name of another menu to substitute for "MAIN." 
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Scanning Rate Selection 

The speed with which menus should be scanned depends both on 
the degree of handicap of the user and the user's experience with 
the system. Permissible speeds range from 1 (very slow) to 30 
(very fast). When the program begins, the scanning rate is set 
at rate 1. Many users will want to select a faster rate. An 
appropriate speed can be found only by trial and error. 

Obviously it is best to start with a slow speed and then adjust 
the speed faster as the user's skill develops. To select a speed 
for scanning, type slash (“/“) and then “s” and follow the 
instructions that appear on the screen. When the menus are 
written out and saved, the scanning rate associated with them 
will also be saved. 

Number of Menu Entries 

The user can choose the number of entries for each menu. 

For a text menu, the maximum number of entries is 3^. As 
explained below in the section on creating pictures, pictures may 
have ^ , 9, 16, or 25 frames. To select the number of entries for 
a menu, type slash ( " / “ ) and then M n“ . The computer will ask the 
number of entries desired. Type in the appropriate number and 
press return. For text menus, numbers below 1 or above 3^ will 
not be accepted. For picture menus, numbers other than 9, 16, 

or 25 will not be accepted — the computer will keep asking until 
it is given a “legal” number. WARNING — if you reduce the 
number of entries in a menu, you will lose the last entries in 
that menu. For instance if a menu had length 3^ and you reduce 
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the length to ? you will lose anything you have in menus 25 
through 3^. 

Type of Menus 

You may choose to have all menus be text menus or all menus 
be picture menus. To change the type of menus? press slash ("/") 
and then "t" . If you change menus to picture menus? all menus 
must be legal lengths for picture menus. 

Write Out All Menus 

Once all desired editing changes have been made? you may 
want to write all the menus out to a diskette. If you write them 
to a diskette that already has menus on it you will destroy those 
menus. Thus if you want to save all your old menus? put a fresh 
backup copy of your Talkhelper diskette into drive A when you 
give the instruction to write out menus. WARNING 1 . ! I If you have 
removed all references to a menu? it will be lost when the menus 
are written out? unless you add at least one reference to the 
menu before writing out the menus. To write out all the menus? 
press slash ( " / " ) and type M w“ . 

Do Nothing 

If you press slash ("/") by accident or if you change your 
mind and do not want to take any action to with respect to menus? 
press "x" to return to where you were before. 



SPECIAL EDITING MODES 



O 

ERIC 

MMfflBBIiLIIJ 



St egging or Scanning Key 1^ t 

A handicapped user may want to edit his own menus? but may 
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lack the physical capacity to use the keyboard? and so will have 



to use the scanning or stepping mode. 

Sometimes a handicapped user will lack the physical or 
mental ability to edit his own menus. This will sometimes be the 
case with respect to text menus and will be assumed to always be 
the case with respect to picture menus. In this case a helper 
will be needed to enter the menus. The helper will want to use 
typed input and in editing the text to be spoken and actions to 
be taken with a picture menu will want to see and edit typed 
information on the screen rather than a picture. There is a 
special command to allow this type of editing. While holding 
down the Control Key? press E (for Edit). This will convert the 
entry mode to typing and will display the associated text if a 
picture menu is accessed. To return to the normal settings? 
while holding down the Control Key? press R (for Regular). 
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CREATING PICTURES 

As mentioned above? a menu may have an associated picture 
that is displayed on the screen when the menu is accessed. In 
this case the menu is not normally seen (but it always can be 
accessed by pressing Control-E as described above). Pictures are 
edited with a "mouse” and p ictur e-dr awing software. A mouse is a 
small device that when moved around on a table causes its 
position to be input to the computer. Pic ture-dr awing software 
works with a mouse to facilitate drawing and editing pictures. 
Pictures can originally be created either with a mouse and 







p ic ture-drawing software or with a television camera attached to 
the computer- (Mouse Systems and Microsoft each sell a mouse for 
the IBM Personal Computer; Koala sells a picture drawing tablet 
and software; Micron Technology and Micromint sell digital 
television cameras; Chorus sells interfaces for ordinary 
television cameras. All these companies advertise regularly in 
Byte and in magazines for IBM computer owners.) 

Unfortunately? handicapped persons who need picture menus 
generally lack the physical coordination and cognitive ability 
needed to create pictures. Therefore it is assumed that picture 
menus will be created by a parent? teacher ? or other helper. The 
first step is to become thoroughly aquainted with the mouse and 
p icture-drawing software by reading the manual that accompanies 
them and going through the introductory information in the 
manual . For each picture menu? the helper should decide on the 
number of picture frames to appaear on the screen. Options 
available are: 2 x 2 squares)? 3 x 3 (9 squares)? 4 x 4 (16 

squares)? and 5x5 (25 squares). On the Talkhelper disk are 

four ready made picture templates? P4 ? P9 ? P16? P25? 
corresponding to these options. The helper should load the 
appropriate template into the p i c tur e-dr aw i ng software system. 
Pictures may be drawn into the squares using the mouse and the 
p i c t ur e— d r aw i ng software. Pictures may be read in from other 
picture files already on the disk? using the “cut and paste" 
option of the picture-drawing software to transfer them to the 
template. Words may be added to the template in combination with 
pictures or separate from them? depending upon the reading 
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ability of the user- (The picture-drawing software systems 
provide very convenient facilities for adding words to pictures.) 

The resulting picture should be saved on a working copy of 
the Talkhelper diskette with a name identical to that of the 
menus with which it is to be associated. 

An alternative to drawing the pictures is to photograph them 
with a television camera attachment and store them on a diskette. 
The mouse and the picture-drawing software system can then be 
used with the "cut and past" option to combine pieces of these 
photographs into the final picture. 



USING TALKHELPER AS A SPEECH AID 
SELECTION OF PHRASE OR ACTION WITH A TEXT MENU 
Etill Selection Mode 

To select the phrase or action cor r espond i ng to a label on 
the screen press the key cor r espond i ng to the letter or number to 
the left of the label. Phrases selected will gradually build up 
on the screen. To remove the most recent phrase selected? press 
the BACKSPACE KEY. To remove all the phrases from the screen? 
press the ESCAPE key. To remove all text press the ENTER key. 

Keyboard Stepping Mode 

When it reaches the desired menu entry? press any key other than 
the space bar. To get the effects of the BACKSPACE? ESCAPE? and 
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ENTER keys,, select the menu items with those names. 

Two Switch Stepping Node 

An asterisk will appear above the left hand column of menu 
entries. To select the right hand column, press the first 
switch, and the asterisk will move to above the right hand 
column. (If you want to go back to the left hand column, again 
press the first switch again.) When the asterisk is 
above the column you want, press the second switch bar to move 
the asterisk down to the first entry. Now you can press the 
second switch from menu entry to menu entry. When it reaches the 
desired menu entry, press the second switch. To get the effects 
of the BACKSPACE, ESCAPE, ENTER, SLASH, and PERIOD keys, select 
the menu items with those names. 

Keyboard Scanning Node 

An asterisk will appear above the left hand column of menu 
entries. To select the right hand column, promptly press any key 
and the asterisk will move above the right hand column. (If you 
want to go back to the left hand column, again promptly press any 
key other than the space bar.) when the asterisk is above the 
column you want, wait, and it will begin to go downward from 
entry to entry, pausing at each entry. While it is next to the 
entry you want, press any key to select that entry. To get the 
effects of the BACKSPACE, ESCAPE, and ENTER keys, select the menu 
items with those names. 

Single Switch Scanning Node 

An asterisk will appar above the left hand columnof menu 
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entries. To select the right hand column, promptly press the 
switch and the asterisk will move above the right hand column. 

(If you want to go back to the left hand column again, promptly 
press the switch.) When the asterisk is above the column you 
want, wait, and it will begin to go downward from entry to entry, 
pausing at each entry. While it is next to the entry you want, 
press the switch to select that entry. To get the effects of the 
BACKSPACE, ESCAPE, and ENTER keys, select the menu items with 
those names. 

SELECTION OF PHRASE OR ACTION WITH A PICTURE MENU 
Full Keyboard Sej.ectj.gn Mode 

To select the phrase or action cor r espond i ng to picture 
frame on the screen, press the key cor respond ing to the letter in 
the frame. If a phrase is selected it will be spoken. If a new 
menu is selected, the program will put that menu. on the screen. 

Keyboard Stepping Mode 

A lighted inner frame will flash inside the first picture 
frame. Press the space bar to move the lighted frame from frame 
to frame. When it reaches the desired frame, press any key other 
than the space bar. 

Two Switch Stepping Mode 

A lighted inner frame will flash inside the first picture 
frame. Press the first switch to move the lighted inner frame 
from frame to frame. When it reaches the desired frame, press 
the second switch. 
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Key bo ar d Scanning Mode 

A lighted inner frame will jump from frame to frame? pausing 
at each frame. While it is around the entry you want? press any 
key to select that entry. 

S_i ng J,e Switch Scanning Mode 

A lighted inner frame will jump from frame to frame, pausing 
at each frame. While it is around the entry you want, press the 
switch to select that entry. 

SUPPLEMENTAL ENTRY MODES 

The following supplemental entry modes are availably to let 
a handicapped person unable to use the normal keyboard make 
entries using a scanning or stepping mode. They are available 
only with text menus and are automatically actived if the text 
menu is in the cor respond ing mode. When the computer asks 
a question as part of the editing process, the following 
list of keys will appear on the bottom of the screen: 

? < * ! 8*0123456789 

ETAOINHNSRLUDYWGMCBFKPVJXZ 
If the menu in one of the stepping modes, a stepping cursor will 
appear at the left of the first row of keys. If it is in a 
scanning mode, a scanning cursor will appear at the left of the 
first row of of keys. The operation of stepping and scanning 
modes are exactly as described above, except that instead of 
choosing between vertical columns, the user can choose between 
horizontal rows. Selecting a letter, number, symbol is the same 
as typing the cor respond ing key, except that selecting " ? " is 
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equ i va 1 ent 
equ i va 1 ent 
equ i va 1 ent 



to pressing the BACKSPACE key, selecting 
to pressing the ENTER key, and selecting 
to pressing the ESCAPE key. 
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INTRODUCTION 



Talkhelper is a program designed to allow non-speaking 
persons to use a personal computer with a speech synthesizer as a 
substitute voice. Many non-speaking persons have other physical 
or mental handicaps. Talkhelper offers flexibility in selection 
of input devices and screen displays so that it may be customized 
for each user to make maximum use of his or her abilities and to 
compensate for his or her disabilities. 

This manual is for use with Talkhelper for the Apple 
Computer. (Other versions of Talkhelper are available for the 
IBM Personal Computer and the Radio Shack Model 100 portable 
computer . ) 

PURPOSES OF THIS MANUAL 

This manual has four purposes: 

1. To tell you how to set up the computer? speech 

synthesizer? and input device for use with the Talkhelper 
software ? 

S. To help you configure the Talkhelper software for the 

computer? synthesizer? input device? and options you want? 

3. To explain how to create and edit screen menus? 

A. To explain how to use Talkhelper as a speech aid. 

DO I HAVE TO READ ALL OF THIS MANUAL? 

If you are planning to install the speech synthesizer? input 
devices and Talkhelper yourself? you should study the sections of 
this manual on installation before you try to install the 
synthesizer? input devices? and Talkhelper. If someone else has 
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installed the synthesizer, input devices, and Talkhelper for you, 
you can ignore these sections of the manual. 

All of the rest of the manual is important, regardless of 
what synthesizer you use and regardless of who installs it. 

SELECTION OF COMPUTER, SPEECH SYNTHESIZER, AND INPUT DEVICES 
COMPUTER SELECTION 

This software is designed to function with the Apple lie 
Personal Computer. Unless you have considerable computer 
expertise, you should buy a new computer from a local authorized 
Apple dealer so that you can get qualified help in setting up the 
computer and warranty repairs if necessary. If you do have 
computer expertise, you may be able to save money by ordering a 
computer by mail or by buying a second-hand computer. 

All models of the Apple lie Personal Computer come equipped 
with the diskette drive and memory needed for this program. A 
color monitor is desirable, but not necessary for picture menu 
displays — you can use a black and white, green screen, or amber 
screen monitor with picture menus. 

SPEECH SYNTHESIZER SELECTION 

You should use the Street Electronics Echo synthesizer for 
the Apple lie. 

INPUT DEVICE SELECTION 

Some persons with speech handicaps can use the computer 

0 
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keyboard very well. 



However, since many persons with speech 



handicaps also have other disabilities which prevent them from 
typing on the regular computer keyboard* Talkhelper allows the 
use of different input devices so that each user can use the form 
of input best adapted to his or her disabilities. 

The possible devices are: the regular Apple lie Personal 

Computer keyboard or special switches connected to the joystick 
connector on the computer. The following discussion is meant to 
help you choose an input device. Often it is obvious which 
device should be used. Sometimes it is difficult to determine 
which device is best* and it may be necessary to try several 
types of input device and to seek the advice of an appropriate 
health care or education professional. Some users may be able to 
advance to more complex input devices that provide faster control 
of the computer. The discussion below will consider factors in 
choice of input devices for users with speech disabilities 
only* or those with speech disabilities and with poor motor 
control, poor vision* poor or no reading ability, or poor memory. 
The various possible types of input device and the ways in which 
the can be used will be considered in turn. 

COMPUTER KEYBOARD INPUT 

The computer keyboard has two great advantages and two great 
disadvantages. The two great advantages are that a keyboard 
comes at no extra charge with every Apple lie Personal Computer 
and that a good typist can enter any English phrase at high speed 
using the keyboard. The two great disadvantages are that the 
keyboard is hard to use for persons with physical disabilities 
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and hard to understand for persons with cognitive disabilities. 
Talkhelper offers several ways to use the keyboard to allow 
customization for different types of users. 

Full Keyboard Input 

Full keyboard input is ideal for a person with speech 
disabilities, but no other disabilities. With a relatively small 
investment of time such a person should be able to learn typing, 
a skill with many applications, and should be able to reach a 
typing speed of over 50 words a minute. Such a person will be 
able to use Talkhelper to say anything he or she wants at a speed 
of at least 50 words a minute, as compared to a normal speech 
rate of 80 to 100 words a minute. 

Full keyboard input may also be possible for a person with a 
moderate level of physical disability. The disability may reduce 
the accuracy with which keys are pressed, the speed with which 
they can be reached, or may prevent use of the shift key. Even 
with these problems, it may be possible to get satisfactory 
results from Talkhelper. Often accuracy can be improved 
substantially by the use of a keyguard or an oversized keyboard. 
(These are available from companies supplying computer products 
for handicapped users.) If the disability substantially reduces 
the speed with which keys can be selected, the user will probably 
wish to supplment typed text with phrase selection input (see the 



section below entitled "Phrase Selection" ) . 



ted Keyboard Input 

Users with poor accuracy, limited reach, or inability to 
understand the complexities of a full typewriter keyboard may 
benefit from an option of Talkhelper that allows the assigning of 
the whole keyboard to be treated as a single switch or of the 
spacebar and the rest of the keyboard each to be considered as a 
swi tch • 

SWITCH INPUT 

Switch input also has advantages and disadvantages. The 
advantages of switches are that they are easy to buy and attach 
to the computer and that they can be used by persons with 
physical handicaps that prevent pressing keys on the computer 
keyboard. One disadvantage is that input is much slower than 
with full keyboard typing. Another disadvantage is the 
difficulty users with limited cognitive ability may have in 
associating closing switches with what is happening on the 
screen . 

Talkhelper can be configured to work with either one or two 
switches. The two-switch input mode offers better control and 
faster input than the one-switch mode. Therefore it is the 
preferred mode for persons who can operate more than one switch. 



The synthesizer should be placed in a slot in the Apple lie 
in accordance with the instructions in the synthesizer manual. 

It should be tested using the software provided by the 
synthesizer manuf ac turer . 



INSTALLING THE SPEECH SYNTHESIZER 
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INSTALLING THE INPUT DEVICES 



Keyboard 

The keyboard comes with the Apple lie computer, so no 
special purchase or installation is necessary if you plan to use 
the standard keyboard as the only input device. If a user cannot 
use the standard keyboard, because of poor motor control, he may 
be able to use the keyboard with a metal keyguard (These are 
available from companies supplying aids for the handc i apped . ) 

Switches 

Talkhelper may be used with either one or two switches. Two 
switches allow much better control and faster communication than 
one switch. The switches should be attached to the Apple lie 
joystick port in accordance with the instructions provided by the 
switch manufacturer, Switches and connecting cables are 
available from companies specializing in devices for the 
physically handicapped. 



MAKING WORKING COPIES OF THE TALKHELPER SOFTWARE 
Before configuring the Talkhelper software you should make 
several working copies of it. To make a working copies follow 
the instructions in the Apple DOS manual for copying a disks with 
the COPYA program. Then put the original Talkhelper disk and one 
working copy in a safe place to use in case your other copies are 
damaged or wear out. Now you are ready to configure the working 
copy for particular hardware and a particular user. If different 
persons will be using Talkhelper, for instance various students 
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in a special education classroom? a separate working copy of the 
disk will be have to be configured to meet the needs of each 
student. The following discussion will aid you in deciding how 
to configure the software for suers with particular handicaps. 

DESIGNING SCREEN DISPLAYS 

Once the computer has been configured for type of 
synthesizer? type of pronunciation? and input mode? it is 
necessary to design what will be displayed on the screen and what 
will be output from the computer to the speech synthesizer. The 
following discussion will first discuss the theory behind the 
various options for screen display for speech-handicapped 
persons? and their advantages and disadvantages? and then will 
indicate exactly how to design Talkhelper screen displays. 

THEORY OF SCREEN DISPLAY 

Screen display serves five purposes. First? it can present 
a list of alternatives to prompt the user who is unable to 
remember the effect of a complex set of keypresses or switch 
closures. Second? it can enable users of stepping or scanning 
modes to coordinate their input actions with the stepping or 
scanning. Third? it can provide information to a person helping 
or training a user on what the user is trying to do. Fourth? it 
can provide necessary feedback and information during the process 
of selecting alternatives and editing menu selections. 
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The Screen D i. sgl. ay as an Aid to Memory 



The screen display aids the user who can 


ot remember the 


effects of various keypresses. This use of t 


? screen display 


can be compared to the function of the menu i 


the typical 


Chinese restaurant in the United States. Usu 


lly this menu will 


contain a list of dishes, each with a number 


nd a short name, 


e.g. "4. Sweet and Sour Pork." The customer 


ran tell the waiter 


the numbers for the selections he wants and s 


on a del ic ious 


Chinese meal will be served. There are reall 


three aspects to 


this menu. The name of the dish on the menu 


"Sweet and Sour 


Pork") serves as a short description to remin 


the American 


customer of what dishes are available. The n 


Tiber serves as a 


means of communication with the Chinese waite 


(who may not 


understand English).. The waiter then may yel 


the order back to 


the kitchen in Chinese, "Please prepare one o 


der of Sweet and 


Sour Pork." Similarly the screen display sys 


em of Talkhelper 


has three parts. Each item on the screen ha 


three parts: < 1 ) 


a designator — a letter or a number that ser 


es the same 


function as the number next to the name of th 


dish on the 


Chinese restaurant menu; (2) a label — a w 


rd or phrase that 


serves the function of the name of the dish c 


the Chinese 


restaurant menu; (3) in the computer memory, 


but not normally 


appearing on the screen, the actual action th 


t selecting the 


particular designator will cause the computer 


to make, 


corresponding to the action that will result 
waiter in the restaurant. 


rom a request to a 


Take the following example. There may t 


an entry on the 
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screen that appears as a picture as a glass of milk and in one 
corner the label: 

M. Milk 

When the user presses the designator "M" that is next to the 
label "Milk") and on the picture of the glass of milk the the 
action the computer will take is to say the correspond i ng phrase 
that has been previously entered) e.g . 5 "I’m thirsty) please get 
me a glass of milk." 



The menu is; necessary in a Chinese restaurant because most 
people cannot remember the huge variety of dishes in the Chinese 
cuisine) and because it provides a simple and fast method of 
communication even if the waiter does not understand English.. 
Likewise) once a computer is programmed to say a large number of 
phrases) a menu may be necessary to help the user remember all 
the phrases and to provide a fast and simple means of 
communication with the computer) which) like many foreign 
waiters) does not understand English. However one menu or one 
screen display may not be enough. In a restaurant) the menu 
might get too big if the owner tried to put everything on it. So 
the menu may say> "Please ask if you want to see the banquet 
menu) the cocktail menu > or the children’s menu." Customers may 
then obtain these menus from the waiter. The need for such 
supplemental "menus" or displays is far greater on the computer) 
since a single screen display can hold much less information than 
a typical restaurant menu. Thus one of the actions the user must 
be able to command from the computer is to display additional 
screens of information with additional options. 
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Q22EdiD§ii2D 2f iDgut Actions with Item Selection 
ID Scanning and St egging Modes 

In scanning and stepping modes? the screen display provides 
coordination of user input actions with selection of items. For 
instance? in a single switch system? a lighted frame may move 
from item to item on the screen. The user needs the information 
on the screen to be able to close the switch at the right time to 
select a particular phrase. In stepping mode? the user closes 
one switch to step the frame from item to item and then presses a 
different switch to select a phrase. Here again? screen feedback 
is needed to allow the user to see which phrase is currently 
indicated by the frame. 

iDf f 2E the Person Helping or Training the User 

Some users may need considerable help in learning to use 
Talkhelper. The screen display will enable persons helping users 
to see exactly what the user is doing? and thus to provide the 
necessary assistance. 

HOW TO USE TALKHELPER 
The Sample Programs 

There are sample menus programs on the Talkhelper Diskette. 
You should read these instructions through and then work for a 
while with the sample menus before you try to create your own set 
of menus. To run TALKHELPER? just type RUN TH and press the 
RETURN key. 

After you have practiced with these menus? you will be ready 
to create and edit menus for a particular user. 
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Every user will have different needs in terms of what the 
user wants to say and the type of pictures and labels the user 
needs as memory aids in order to be able to make selections. 
Talkhelper is not based upon any preconceived model of what the 
user should want to say or how much memory assistance the user 
needs. Rather it is left to the user or someone helping the user 
to create memory aids and phrases to be spoken that are 
appropriate to the particular user. 

Editing Menus 

To create a new set of menus or alter an existing set, first 
use the COPYA program on the DOS 3.3 diskette to make a copy of 
your working copy of the Talkhelper master diskettes (for a new 
set of menus), or make a copy of the diskettes with the set of 
menus you wish to alter. Now type RUN EDIT and press RETURN. 

Each set of menus has two settings that apply* to the whole 
set. These are the number of frames (or boxes) per screen and 
the type of input. In addition, scanning menus have a scanning 
speed setting. The first step with the EDIT program is to answer 
questions about these settings. 

If you have a A frame per screen system, there will be an 
initial menu display with A frames. These can be used to select 
A submenus, each of which will also have four frames. These 
submenus are called "A", "B", "C" , and "D" . Follow the 

instructions to choose a submenu. Each submenu will have four 
phrases to be spoken, one associated with each frame as follows: 

A B 

C D 
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Choose the line of text you wish to edit and enter its new value. 

If you have a 9 frame per screen system, there will be an 
initial menu display with 9 frames. These can be used to select 
9 submenus, each of which will also have four frames. These 
submenus are called "A", "B", M C" , "D M , "E" , "F" , "G" , "H", and 

"I". Follow the instructions to choose a submenu. Each submenu 

will have nine phrases to be spoken, one associated with each 
frame as follows: 

ABC 
D E F 

G H I 

Choose the line of text you wish to edit and enter its new value. 

If you have a 16 frame per screen system, there will be an 
initial menu display with 16 frames. These can be used to select 
16 submenus, each of which will also have four frames. These 
submenus are called "A", "B", "C" , "D M . "E M , "F", "G" , "H", "I", 

"J", "K" , "L", "M" , "N", "0", and "P". Follow the instructions 

to choose a submenu. Each submenu will have sixteen phrases to 
be spoken, one associated with each frame as follows: 

A BCD 

E F G H 

I J K L 

M NOP 

Choose the line of text you wish to edit and enter its new value. 
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CREATING PICTURES 



Pictures are best edited with the "Apple Mouse"? the Gibson 
Light Pen"? or the "Koala Pad" and the picture-drawing software 
supplied with them. Pictures can originally be created either 
with these devices and their picture-drawing software or with a 
Micron Eye television camera attached to the computer 

Unfortunately? handicapped persons who need picture menus 

f 

generally lack the physical coordination and cognitive ability 
needed to create pictures. Therefore it is assumed that picture 
menus will be create by a parent? teacher? or other helper. The 
first step is to become thoroughly aquainted with the Gibson 
Light Pen or the Koala Pad and the picture-drawing software by 
reading the manual that accompanies them and going through the 
introductory information in the manual. For each picture menu? 
the helper should decide on the number of picture frames to 
appaear on the screen. Options available are: E x E <4 

squares)? 3 x 3 (9 squares)? and 4 x 4 ( 16 squares). On the 

/u$i> 

Talkhelper disk are four ready made picture templates? ? -P9? 
/woj) 

and ^16? corresponding to these options. The helper should load 
the appropriate template into the picture-drawing software 
system? following the instructions in the picture-drawing 
software manual for loading a screen image. (The pictures may 
then be drawn into the squares using Apple Mouse? the Gibson 
Light-Pen? or the Koala Pad and the picture-drawing software. 
Pictures may be read in from other picture files already on the 
disk? using the "cut and paste" option of the p i c ture-drawi ng 
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software to transfer them to the template. Words may be added to 
the template in combination with pictures or separate from them) 
depending upon the reading ability of the user. (The picture- 
drawing software systems provide very convenient facilities for 
adding words to pictures.) If full keyboard input is to be used) 
it is important to put a letter ("A") "B") "C") "D") etc.) in 

each frame corresponding to the key that will need to be pressed 
to say the message represented by the picture in the frame. 

The resulting picture should be saved on a working copy of 
the Talkhelper diskette in a file named with a letter identical 
to that of the menu with which it is to be associated. 

An alternative to drawing the pictures is to photograph them 
with a television camera attachment and store them on a diskette. 
The Gibson Light Pen or the Koala Pad and the picture-drawing 
software system can then be used with the "cut and paste" option 
to combine pieces of these photographs into the final picture. 

USING TALKHELPER AS A SPEECH AID 

SELECTION OF PHRASE OR MENU 
Etill Keyboard Selection Mode 

To select the phrase or menu correspond i ng to picture frame 
on the screen) press the key correspond i ng to the letter in the 
frame. If a phrase is selected it will be spoken. If a new menu 
is selected) the program will put that menu on the screen. 
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Keyboard Stepping Mode 

A lighted inner frame will flash inside the first picture 
frame. Press the space bar to move the lighted frame from frame 
to frame. When it reaches the desired frame? press any key other 
than the space bar . 

Two Switch Stepping Mode 

A lighted inner frame will flash inside the first picture 
frame. Press the first switch to move the lighted inner frame 
from frame to frame. When it reaches the desired frame? press 
the second switch. 

Keyboard Scanning Mode 

A lighted inner frame will jump from frame to frame? pausing 
at each frame. While it is around the entry you want? press any 
key to select that entry. 

Singie Switch Scanning Mode 

A lighted inner frame will jump from frame to frame? pausing 
at each frame. While it is around the entry you want? press the 
switch to select that entry. 
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INTRODUCTION 



Talkhelper is a program designed to allow non-speaking 
persons to use a personal computer with a speech synthesizer as a 
substitute voice. 

This manual is for use with Talkhelper for the TRS-80 Model 
100 Portable Computer. (Other versions of Talkhelper are 
available for the IBM Personal Computer and the Apple lie 
Personal Computer.) 

THE COMPUTER AND THE SYNTHESIZER 



THE COMPUTER 

This software is designed to function with the Radio Shack 
TRS-80 Model 100 Portable Computer. Unless you have considerable 
computer expertise* you should buy a new computer from a local 
authorized Radio Shack Dealer so that you can get qualified help 
in setting up the computer and warranty repairs if necessary. If 
you do have computer expertise* you may be able to save money by 
ordering a computer by mail or by buying a second-hand computer. 

To be used with this program* the TRS-80 Portable Computer 
must have 3SK of RAM memory. (Any Radio Shack computer dealer 
will be happy to sell and install additional memory* if necessary 
to bring the total memory up to 32K . ) 

THE SPEECH SYNTHESIZER 

This software requires a special speech synthesizer for the 
TRS-80 Model 100. You should follow the instructions supplied 



with the synthesizer to install it. 
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MAKING WORKING COPIES OF THE TALKHELPER SOFTWARE 
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Before configuring the Talkhelper software you should make 
several working copies of it. Talkhelper is supplied on two 
cassettes. One contains a copy of a program called TALK. The 
other contains a copy of a program called HELP. 

To make copies of TALK place the TALK cassette in the 
cassette recorder , ready the recorder i select BASIC from the 
menu, then type: 

CLEAR 45000, S56 <ENTER> 

LOADM "TALK" 

When TALK is successfully loaded insert and rewind a blank data 
cassette in the recorder and type: 

SAVEM " TALK " , 45000 , <?/*7 

To make an additional backup copy, once again insert and rewind a 
blank data cassette in the recorder and type: 

SAVEM "TALK" ,45000,^°' * I 

To make copies of HELP, place the HELP casette in the 
cassette recorder, ready the recorder, select BASIC from the 
menu, then type: 

LOAD "HELP" 

When HELP is successfully loaded, insert and rewind a blank data 
cassette in the recorder and type: 

SAVE "HELP" 

To make an additional backup copy, once again insert and rewind a 
blank data cassette in the recorder and type: 



SO 



SAVE "HELP 



USING TALKHELPER AS A SPEECH AID 



STARTUP 

To start Talkhelper, you must first load the TALK* the 
Talking BASIC System from the cassette. The Talking BASIC System 
is designed to allow you to run talking programs written in BASIC 
and to write talking programs in BASIC. To load the Talking 
BASIC System? type: 

CLEAR 45000,256 

and then, being sure that the diskette with the TALK program is 
ready in your cassette recorder, type: 

RUNM "TALK" 

At this point the Talking BASIC Program is loaded, but not 
activated. Special talking programs for the Model 100 will 
activate it automatically. Details on how you can write your own 
talking programs are given in the Appendix. 

To run Talkhelper, once TALK is loaded, put the rewound 
cassette with the HELP program in the recorder and type: 

RUN "HELP" 

The computer is now ready to function as a speech aid. The 
Talkhelper program may be left functioning indefinitely, by 
keeping the computer plugged into a 110 volt house current 
adapter when it is not being carried around. 

To use Talkhelper, merely type in any English word or phrase 
and press the ENTER key. If you wish to say the phrase again, 
just press the ENTER key. 
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APPENDIX 



WRITING TALKING PROGRAMS 

Once Talking BASIC is loaded) you may activate it in your 
own BASIC programs by executing the following command: 

CALL 45059 

When Talking BASIC is activated) anything printed on the scren 
will be spoken . 

(You may deactivate the Talking BASIC at any time by 
execut i ng : 

CALL 45062 

You may then reactivate it at any time by 
executing: 

CALL 45059 

Warning — you must deactivate Talking BASIC before leaving BASIC 
to go to the main menu or options on the main menu will not work. 
If you accidently exit to the main menu with Talking BASIC 
activated) you must restart the computer by turning off the 
master power switch on the bottom of the computer) removing any 
110 volt adapter) waiting a minute> and then turning the computer 
on again. 

SPEECH OPTIONS 

The standard features of Talking BASIC attempt to imitate 
what a person would say if he were asked to read what was being 
written to the screen. However) there are a number of options to 
alter how text is read from the screen. 
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Spelling or Whole Words 

When Talking BASIC is activated, it reads by whole words, 
some uses, you may want words spelled letter by letter. To have 
words spelled out, type CALL 45065 To return to normal whole 
word pronunciation press type CALL 45068. 



Remembers CALL 45065 for letter by letter spelling; 

CALL 45068 for whole word pronunciation. 

Pune tuat ion 

In normal reading, special symbols such as and are 

usually read out, but common punctuation marks such as period and 
comma are not pronounced. When Talking BASIC starts, it is in 
normal reading mode. All special symbols and all punctuation on 
the screen are pronounced except the followings dash, period, 
comma, semicolon, exclamation point, question mark, star, double 
quotes, apostrophe, tilde, grave accent, vertical line, 
backslash, left parenthesis, right parenthesis, left bracket, 
right bracket, left brace, and right brace. When reading 
numbers, a decimal point will be pronounced as point. If a 
combination of digits, dollar signs, commas, and periods is 
encountered that is not a well-formed number or monetary amount, 
all characters will be pronounced to alert the user to the 
unusua 1 situation. 

This option is called “Some" punctuation. If you have 
switched to another punctuation option, you can return to "Some" 
punctuation by typing CALL 45074. 

When proof read ing , it is usual to pronounce all punctuation 
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but not to indicate spaces. This option is called "Most” 
punctuation. It is available by typing CALL 45077. 

Finally, for some purposes it is necessary to know exactly 
what is on the screen, including spaces. This option, called 
"All" punctuation, is available by typing CALL 45071. 



Remember : 



CALL 


45074 


i s 


for 


some punctuation; 


CALL 


45077 


i s 


for 


most punctuation; 


CALL 


45071 


i s 


for 


all punctuation. 
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SOURCE CODE FOR SCREEN-VOICE FOR THE IBM PERSONAL COMPUTER 
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/* files DEFS.C 

1 a s t e d i t e d b y p m 
3 : 34 p . m . <1 hay 1 2 ? 1 935 

*/ 

/ * * * ft ft ftr * ft* ft- * V- ft ft ft ft ft ft ft ft ft ft ft ft * * ft ft * * ft * ft ft ft ft ft- / 

/ft DEFINITIONS */ 

/ ft r ft ft ft ft - ft ft * * * ft* ft- ft- * * * ft * ft- * * ft ft ft * * ft- * ft * ft- ft * ft- ft- / 

/ ft- 3. o g i e a 3. v a 3. u e s: * / 

tt : d e f i n e E G L C * \ 0 i 5 " / * e n d o f 3. i n e c h a r * / 

ttdefine EOF -1 /ft end of file ft/ 

/ft End of phrase character (carriage return) for 

E C H 0 - P C <i T y p e -- ? N -Talk? I n t & x - T a 3. k e r ? M i c r o - V o x * / 

#define EOF 13 

/ * acre e n s i z e s -ft / 
ttdefine MAXLINE 24 
ttdefine MAXCOL 79 

/ ■ft table sizes for user custom pronunciation tables: ft/ 
ttdefine TSIZE 40 

/•ft string space for user tables: ft/ 

#define USIZE 800 

/ft size of buffer for synthesizer-specific parameters (file "synth"): */ 
# d e f i n e SBF S I Z E i 0 0 0 



/ft toupper (c: ) and tolower(c) defined for ASCII character set ft/ 



ttdefine TGUPPER ( c ) ( (c >* 9 a 9 && c 
ttdef i ne T GLOWER ( c ) ( ( c > = A " && c 



1 z * ) 



(c 

(c 



32 ) : c ) 

32 ) s c > 



/ft a I phabe t i c < c ) and numeric <c) defined for ASCII character set ft/ 
#def i ne ALPHABET I C < c ) ( c >= ? a *“ && c <« ? z 7 ) 
ttdefine NUMERIC(c) (c >= "O’ && c <> ) 



/ ft g e n e r a 1 d e f i n e s s ft / 

ttdefine NULL 0 

ttdefine TRUE 1 

ttdefine FALSE 0 

ttdef i ne BACKSPACE 0x08 

tt d e f i n e N E W L I N E 0 x 0 d 

ttdefine DELETE 0x?f 

tt d ef i ne F AKE5P ACE 0 x 1 f 

/ ft ft ft ft ft* ft ft ft ft- ft ft- ft ft ft ft ft- ft ft ft- ft- ft- ft ft- S / 

./ft- The following definitions are used for our commands: ft*/ 

/ft default for initiating Screen Review:*/ 
ttdefine SCREENKEY ? \014 ? " /ft Control -L */ 



/ft default, for initiating Mode Change: ft- / 

O -fine MODE KEY p \05" ~ /ft control -E ft/ „ _ 

ERIC 15 

commands while in screen review mode: ft/ 



#def ine 


AUDIQKEY " A ’ 


/ 


# define 


BACKKEY ’B’ 


/* 


#def ine 


DOWNKEY r D r 


/* 


#def ine 


FINDKEY ’ F 


/ *r 


ilrief i ne 


LINEKEY ’ G ’ 


/* 


#def ine 


LEFTKEY ’ L 


/ Vr 


. ^define 


RIGHTKEY ’R’ 


/ *■ 


# define 


MARK KEY ’ M ’ 


/* 


#d ef i ne 


UPKEY ■- U r 


/* 


#def ine 


RESTKEY 11 \ 0 1 5 r 


/ * 


# define 


ESCKEY ’ \033 ’ 


/* 


/ * c o m m a n d s t o c h a n q e 


gener i 


# define 


ALLKE Y ? A ? 


/* 


# define 


BRAVOKEY ? B 


/* 


# define 


CUSTKEY *C* 


/ «- 


# define 


NUMKEY *D* 


/* 


#define 


PAUSEKEY r E 9 


/ * 


/* ttdefine ’ F ’ 

# define RPLJNCKEY ’ G ’ 


/* 


#def ine 


HELP KEY ? H ? 


/* 


#def i ne 


INTONKEY r I :i 


/* 


#def i ne 


SKIM KEY 9 J 9 


/* 


ttdef ine 


ECHOKEY ? K 


/ Kr 


#def i ne 


LETTERKEY ? L 


/ 


#def ine 


MOSTKEY 9 M 9 


/* 


#def ine 


NOR HAL KEY ? N ? 


/ 


#def i ne 


COL KEY r 0 ? 


/* 


#def ine 


PITCHKEY "P" 


/* 


/# #define ? Q r 

# define RATEKEY ? R ? 


/* 


#def ine 


SOMEKEY 


/* 


: !4def ine 


TQPKEY r T 


/* 


#def ine 


CAPKEY Hr 


/* 


#def ine 


VOLKEY r V 


/* 


/* #def ine ? W ? 

/* # define ? X 

#def ine CURSKEY *" Y ? 


/* 


#def i ne 


ZAPKEY •■’Z-' 1 


/* 



h e a r p o s i t i o n o f a u d i o c u r s o r 
b a c k t o m a r f s e cl p os i t i o n * / 
cursor down i line */ 
f i n d s p e c i f i e d s t r i n g * / 
q o t o s p e c i f i e d 3. i n e * / 
rri o v e 2* s a y 1 e f t u n i t * / 
m o v e cj: s a y r i g h t u n it * / 
m a r k c la r r e n t p o s i t i o n * / 
cursor up 1 line */ 
c a r r i a g e r e t u r n — s a y r e s t 
Escape gets out of Screen 



*/ 



of line #/ 
Review Mode # 



all punct */ 

spell saying "alpha? bravo" ? etc. ■*/ 
c la s t o rn p r o n la n c i. a t i o n o n / off *-/ 
digits vs. nu mb er s * / 
pause between 'words on/off #/ 

NOW UNUSED */ 

count repeating punct on/off */ 
e c h o f u n c t i o n k e y s c:> n / o f f * / 
i n t o ned v s . flat * / 
s a y o n 1 y b i g w o r d s * / 
key echo on /off *•/ 

s p e 1 1 usi n g n c* r m a 1 let t e r n a m e s * / 
most punct. */ . 

s p e a k n o r m a 1 1 y ? i e - i n w o r d s *:• / 
s a y o n 1 y c e r t a i n c o 1 u m n s * / 
c h a n ge s y n t h e s i z e r pitch * / 

NOW UNUSED */ 

change synthesizer speech rate ■*/ 
s o m e p u n c t # / 

c h ang e f i r s t 1 i ne of sc r een t o sp e a k 
capital letters indicated or not */ 
c h a n g e s y n thesis e r v o 1 u m e * / 

NOW UNUSED */ 

NOW UNUSED */ 

speak cursor position */ 

empty speech buffer *■/ 



/ # v # * # * * # # * * * * #■ # ****** -?f * # *****^***** # # / 

/* SUBROUTINES THAT RETURN NON- INTEGERS */ 

char getscr ( ) ? 
c h a r * i "i u m b e r c h k ( ) ? 
char src ( ) ? 
char Vrsya 1 loc C ) ; 
char *synstr ( ) ; 







/* These variables hold information as to what modes we are in. 

Some are toggles? ie. TRUE or FALSE. Others can have more than 
t w o v a 3. la e s ? d e p e n d i n g o n w h i c h k e y s a f f e c t t h a t m o d e - 



O 

ERIC 

asaaaaasa.: r t a i. k mo d e ? o 1 d t a 1 k m o d e ; 



152 

/* values: BRAVOKEY , LETTERKEY * 



char 


prmode ; 


/■K- va 3.U; 


i n t 


cap tog ; 


/* TRUE i 


i n t 


he Ip tog ; 


/* TRUE 


int 


numtog ? 


/* TRUE i 
d i g i t s 


int 


synch tog ? 


/* TRUE 


i n t 


pause tog ; 


/* TRUE 


i n t 


e c h o tog ? 


/* TRUE 


i i "i t 


r prune tog ; 


/* TRUE 


int 


i n t o n tog? 


/* TRUE 


int 


c us tog ? 


/* TRUE i 



/ Ai r .y. & .y. .y. 4s. g. g. -v- ■«■ •£••#•-*■ v- y. -if «■ v- # -y. .y. -y. .j*. -y. # -y- y y* ■*. -v- ■#> .y. # y •*■ ¥r -K- / 

/ •* T hsse v ariabies c o n t a i n i n f o r m a t i o n o n o t h e r asp e c t s o f 
o u r c u r r e n t s t a t u s . 



■y. / 




char 


1 i neky ? 


char 


modeky ? 


cha r 


dele h 1 ? 


char 


delchS ? 


C h BY” 


bscount 


i n t 


top ? / ■# 



y / 



i n t line? c o 1 u m n ? / * p o s i t i o n o f a u ci i o c: u r s o r #■ / 

int lcol ; /* boundaries for reading specified columns? eg, in a table #■/ 

i n t r col; 

int pitch? /* pitch to be used in setpitchO and setinton( ) */ 

/ £• ■Vr •*■ K- +E* * ■*■ ■* * ■*: - 4€- *- # * # $r * -fc *?r *r / 

/* The f o 1 1 ow i rig ho 1 d command str i ngs needed to te 1 1 the synthes i zer 
to perform specific functions. They are assigned particular values 
when file "synth" is read. “Synth" must be configured by the user 
for his particular brand of synthesizer. 

Note: Since different synthesizers may have command strings of 

different lengths? these variables are merely pointers to objects 
of indeterminate length. The correct amount of storage will be 
all ocated by subroutine " syal loc" dur ing ini t ia 1 i zat ion « 

■ft/ 

char *initstr; /* to initialize the synthesizer */ 

char spausestr? /*• to tell it to pause between words */ 

char #sapstr; /■* to tell it to empty its buffer of anything unspoken *■/ 
vo 1 str [26 ] ; /* to tell it to chanqe volume */ 



O tv 
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*ratestr E263 ; /* to tell it to change the^vgt^e of speech #/ 



char #f pst r C26 II ? /*■ 26 pitches to be used with flat intonation ■*/ 

char *ipstr£263; /■* 26 pitches to be used with normal i ntonat i on #/ 

/ * * if. # ■* # * # # * * -Jr ■«■ ■*■ # * * * *■ #r & X- * * *r * «r ■£ # *r * * * ■£ -X -X- «■ * ■£ / 

/ # 0 1 h e r g 1 o b a 3. v a r i a b less * / 

i n t sc o u n t ; / * c o i.i ri t s n u m b e r of c h a r actsrs s e n t t o sc r e e n * / • 

int in; /* used by subroutine "saychk" to keep track of what mode 

we’ve been in (alphabetic? numeric or punctuation) . */ 

i n t m a r k c o 1 ? m a r k 1 i n e s / # u sed by s u b r o u t i n e ' ' m a r k er 11 (call e-'d b y 

" 1 i n e r e v " ) t o h o 1 d t h e c u r s o r p o s i t i o n t h e u s e r w a n t s m a r k e d * / 



i nt ncomm 5 



int keys? 



char oldci 



int erect; 



/* holds the number of the communications port the user 
has the synthesizer plugged into #/ 

/* "My key" sets this to the last "real" key <ie. not part 
of one of our commands) which we have passed along to 
the user’s program. 11 My screen" then looks at keys to 
determine if the screen char is a key echo. ■*/ 

/* This is used by subroutine "arc" (suppress repeating 
characters) to hold the last character. */ 

/ * 11 s u p p r e s s r e p e a t i n g c h a r a c t e r c o u n t 11 — need e d w h e n 
RPIJNCKEY is activated (in "modeset" ) #/ 



/* The following 6 variables are needed for the user’s custom 
p r o n u n c i a t i o n t a b 1 e . *■ / 

char -x-ctab CTSISE3 5 /* original words to find and match ■*/ 

char *utab CTSIZE3 5 /* substitute words to replace original ones *■/ 

int ltab? /* actual length of table •*/ 

char spaceCUSIZE3 ? /* our program builds the user table in this area 



char #sp ? /^-working pointer to where we are in "space" ■*■/ 
char *se? /*■ pointer end of space */ 

char sbf CSBFSIZE3 ? /* storage for syalloc to use when we read in 

synthesizer parameters from file "synth" */ 

char #sbfp = sbf? /* next free position for "syalloc" *■/ 

char *-sbfe = & : sbf CSBFSIZEIi ? /* last free position */ 

/* Notes These 2 variables must be at the end of the unitialized 
variable position. "Xmine.asm" uses the position of "end ram" 
to tell the operating system where our code and variables end? 
so that we will be protected from trashing by others. 

*:■ / 

int dummy C 30 3 ? 

i n t e n d r a m ? / * LJ s ed b y x rn i n e . a s m t o p r o tect r a m . 

Notes Must be last unitialized variable. */ 



O 



/■*■ The following are used as defines and allow various ascii strings 
t o b e p r o n o u n c e d d i f f e r e n 1 1 y ? a c c o r d i n g t o t h e u s e r ? s c o m m a n d s . 

Certain commands cause the elements of one of these arrays to be 

p laced i r t o t h e a p p r o p r i a t e s p o t s i n a r r a y "ascii”? w h i c h s p e c i f i e s 
t h e c u r r e n t p r o n u n c i a t i o n o f e a c h a s c i i c h a r a c t e r 

/ 

c h a r eos = 3 \ 0 • ; / # e n d o f s t r i n g ( n o t h i. n g said) * / 

c h ar *d i g i t s C U = C 

11 zero " ? " one " ? ” two “ r , “ three “ 5 M four " ? " five " ? ” six % 

11 seven " ;i n eight * 1 5 1 1 nine 1 1 ? 1 1 ten 

"i a 

s ? 



char Steens [II i 

" ten " ? " eleven ” r . " twelve ” ? ” thirteen “ ? " fourteen 
11 sixteen ” ? 11 seventeen M ? 11 eighteen " ? 11 nineteen ,l 



fifteen 



c h a r * t e n s E U •- C 
11 zero " ? “ ten 



twenty 



th ir ty 



forty 



fifty 



seventy " ? 11 eighty 'S'* ninety 



/■«• These 


are 


p u t 


i n 


array 11 


asc i i 


II 


when 




the 


user 


wants 


cap i ta 1 


char #alphaC 3 


= { 


























” cap a 


ii i> 


cap 


b 


11 ? " cap 


c: % 


II 


cap 


d 


M 

? 


“ cap 


e 


H »i 

? 


cap 


f " , 


" cap g 


m n 

? 


cap 


h 


'V cap 


i " » 


II 


cap 


j 


H 

? 


" cap 


k 


H n 

5 


cap 


i" , 


” cap m 


i> ii 
? 


cap 


n 


M ? 11 cap 


o % 


II 


cap 


P 


H 

? 


M cap 


q 


it ll 

P 


cap 


r " , 


M cap s 


ii n 

5 


cap 


t 


%“ cap 


u ", 


11 


cap 


V 


ii 

!* 


” cap 


w 


il ii 

5 


cap 


... ll 
S\ ? 


cap y 

-> u 
.>■ ? 


i> ii 

? 


cap 


z 


1 1 






















/# These 


are 


p u t 


in 


array " 


asc i i 


II 


when 




t h e 


user 


wants 


letters 



in 5 bravo 5 
char *br avo C 3 



m o d e ? w i t h c a p i t a 1 s i n d i c a teds *- / 



II 


cap 


a 1 p h a ” ? 


II 


cap 


bravo " ? 


1 1 


cap 


char 1 ie 


II 


cap 


delta “ 5 


II 


cap 


echo % 


' ll 


cap 


foxtrot 


II 


cap 


golf % 


II 


cap 


hotel M , 


II 


cap 


india " n 


II 


cap 


juliet ” 


1 1 


cap 


kilo % 


II 


cap 


1 i ma 11 ? 


II 


cap 


mike ” ? 


II 


cap 


no v ember 


1 1 


cap 


oscar " ? 


II 


cap 


papa ” ? 


ll 


cap 


quebec " 


II 


cap 


romeo " *» 


il 


cap 


sierra " 


II 


cap 


tango " ? 


II 


cap 


uniform 


II 


cap 


victor 11 


II 


cap 


whiskey 


II 


cap 


x-ray " :» 


1 


cap 


yankee " 


ERIC’ 


cap 


zulu ” 
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eac h 



T h i s a r r a y h o 1 d s p o i n t e v 



t o t h e c u r i " e n t p r o n u n c i a t i o n f o \ 



c i i c h a r a c t e r . The e n t r i a? s m a y b e c: h a n g e d b y c e r t a i n i 



.ISt 



c:o mmand: 



::har 

O: 0 O S h 
JkBOS n 
5:00 a j* 
Sheets - 
Ceos 
£:SOS 
o:0OS 

& : eos ? 
£eos n 

CkSOS j» 
0:00 0 
£■: 0 O S 

keos 

6:90 5 H 

SkEOS ? 
& eos , 

£:905 ^ 
&:0GS « 

Sseos 

^eos 

&:0OS «. 
6:00 5 
0:00 S 
&:0O5 
£-:0OS 
O -. 0 DS ? 
0:00 S 4 

6:00 0. n 
0:00 



^•asciiC ] = i 

/">:■ no pro nunc i < 



1 1 i o n f o r c o n t r o 1 c h a r a c t e r s * / 



/ -V- K & v 
/ -tf 



1 F u s e d w hi e n w e w a n t a Bp a c e n o t p r o n o u n c e d i i 



til 3 mod ? 



e p a c 0 ^ / 



1 " ? /* quotes */ 

'^number sign " «. 

' dollar sign 11 5 
1 percent " n 



tnd 



1 \ ; ’ 



star 

j 1 115 



slash 
sere* 1 
one 11 « 
two " . 
three 
four * 
five ' 
s i >; " i 
seven 
ei gh t 
nine ' 



/# comma */ 
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.i. 0 S 5 



/ * 
t h a. 



semico 1 on *•/ 
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" greater than " ? 

n m 

3 

n at " , 

&eo s ? &eo a ? S:eo a ? keo a ? &eo s ? S:eo a *, S : eo a «. S-.eo a ? S:SD a ? &eo a ? keo a ? &eo a *. S:eo a 
&=eD£ ? &eos ? &eos ? &eos ? heos ? k.eos ? keos ? Sisos « keos * &eos ? c : eoa ? &:sos ? & ; eos 

n ii 

3 

ii n 

r* 

n n 

:l 

M up arrow " « 

n n 

? 

ii ii 

3 

&.eoa ? u:Boa ? &eos ? &eoB ? ^eos «» &=eos ? Sseoa > ^eos? Saoa ? &eos ? ieos ? & : eos ? & : e os 
cxBoa 3 Sseos ? &:eos ? &:eos ? &eos ? &eos ? o-.eoa ? &eos ? koa r , ieos ? &eo a s &eos ? feeos 

ti n 

3 

If ii 

;i 

ii it 

3 

ii i) 

3 

&:BOS 

*» X 

S 3 

/ *■ * * K- * *■ * * * * * •* *• * * * ¥■ * * *■ * -K- * -K- 



o 
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/* files M A I N „ C 

1 a s t e d i 1 0 d b y p m a t 
4 s . 1. 6 p.in, ? May 1 A ? 1 985 

*/ 

/ tf. £. -tf. •¥• -ft -tf- -if. -tf . Xr 4i- & -V- ■*• •£• 4»r ■¥• -X- -£ -tf- ■«■ -$■ •£• *r -Jr * *K“ # ■*■ *■ * * / 

vi ma ( status ? accumu 1 ator ) 
i nt status 5 
i n t a c: c umu 1 a t o r 5 

/# This routine is effectively the ’‘main" part of our C program. 

It is call ed by our machine language ‘routine that intercepts 
operat i ng system ca 11 s. 

"ViiTia" is called once with status ==- 0 on boot-up. 

"Vims" is called with status ~~ 1 each . time a user program 
asks the operating system to get a key from the keyboard? 
w i t h t h e c a 11 c o m i ng b ef o r e t h e k ey has b sen g o 1 1 en . 

"Vima" is then responsible for returning with the requested key 
i n the k e y b u f f e r . 

"Vima" is called with status == £ each time a user program 

asks the operating system to put a character on the screen? 

with the call coming after the character has been put on the screen 

*/ 



char tempch ? 



if (status == 0 ) /* boot-up */ 

r 

i n i t ( > ? 
return ? 



if (status 

r 


1 ) /* get 


a key */ 




my key ( ) ? 


/■* see file "!■ 


■ey" for code 


*/ 


return ? 

j - 








if (status 


===== £> /* put 


character on 


scr 



t e m p c h - a c c u m u 1 ca t o r & 0 >i 007 f ? 
myscreen< tempch ) ? 
r e t lit n ? 

/* end "vima" ■*/ 



•fc. ^ ^ ^ ^ ^ ^ ^ ^ / 



/ * T hi e f o 1 1 o w i n g r out i nes ( i n a 
with "vima" status = 0 or S? 
"myscreen" and all the major 

* / 



phabet ical order) are associated 
i e & sub r o u t i nes " i n it" and 
r ou t i nes t h ey call. 
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•¥• .if. 4#. 4f. Ai. -K- X* ■£■ # -Xr *= Xr -ft ?r 4r Xr -if -ft * # Xr *Xr -Xr -K* # Tr / 



iu 



/* Boot- 


up ini 




s t a t i c 


int i ? 


ncomm = 


0 * 


keyz = 





/#■ initialise command characters: ■*/ 
lineky = SCREENKEY ? 
m o d e k y = M ODE K E V ? 

/* initialize other variables & default, modes. */ 
setup ( ) •" 



saychk ( ? \0 



n i ? > 



send (pausestr ) ? 

say ("screen reeder by veesek and maggs") 



s e n d ( p ause s t r ) ? 




my screen ( a ) 
char a ; 

/* This routine is called only by subroutine "vima" ? and only when 
"vima" has been called with status = 2. This happens just after 
a character is plotted on the screen. 

Since "myscreen" implements key echoing? it must determine if 
the character just plotted is the last key the user pressed 
(saved by "mykey" in variable "keys") 
characters are echoed to the screen a 
and a letter* 

■*/ 



Note that some control 
•2 c ha r ac ter s : up -a r r o w 



static i n t t e m p ? 
i t a t i c i n t ncol ? o c o 1 5 



/ * n e w col u m n &•. old c o 3. u m n * / 



static int nline? o line ? /* new line and old line */ 
static int epos? /* cursor position */ 
static int i ? counter */ 



static char savechoi /•*■ save echoed key here to check for 



/ 



/* Did we just move to a new column that is to the left of the 
old column? (other than by BACKSPACE or DELETE)? 

Such a situation would indicate that a new line has been 
started and we should therefore say the old line. 



epos “ geep < ) ? 
nc o 1 = epos % 256 ; 
n 3. i n e = cp o s / 2 5 6 ? 

if (ncol < o col && key z != BACKSPACE && keyz ! = DELETE) 
saychk ( FAKESPACE ) ? 



O Check up and report on what (if anything) happens on screen 



ERIC 



~r user press 



k s p a c e o r d e 1 e t e 



159 



ViCO 1 



if ( ( keyz =■- BACKSPACE I! keyz = 

r 

+-I- b sc o Lint 5 

SdV ( <£dp ) j! 

if (bscount == 1) 

r 

"I. 

on a 1 1(); 

say < asc i i Cdelch 13)5 
if (prmode ~=" 'S' ) 
on so me ( ) ? 

if ( p r mo d e ‘ n ! V I ) 
onmos t ( > ; 

j 

if (bscount == E &:&. delchS =~ 

r 

ona ].!()? 

say ( asc i i Cdel chS3 ) ? 



D E L b 1" E ) £■*. £ : n I i n e = - o 1 i n e 



= ocol) 



if 


(prmode ~= 
onsome( ) ? 


? S ) 


if 


(prmode = :=:: 


Min 



onmos t < ) ? 



ocol = ncol I 
oline - nlines 



If we 


a r e 


in echo mode 


th 


en we do the 


fo 1 


lowing to see 


if wha 


<£. c= 0 


nt 


t o t h e s cree n 


i s 


an echo of 


a !••: e 


y press . 




Was a 


key 


just pressed 


— 


if so echo 


nex t 


char ac ter on 


screen 


if it 


i s 


the same as th 


e 


key 









or 



if the user press a control key? e n g . Con tr o 1 ~B ? most software 



will echo 



"B? etc- In such cases we want to echo both the 



*/ 



++scount 5 /#• one more character to screen set to zero in mykey */ 



if 

i 



i i 
{ 



( key: 



ERJC 



the B 


i f we a* 


/* o 


ne more * 


u t i f 


we have 


~ r -“ 1 


keyz 


>= 0 


keyz 


unt = 


= 1 && a 


IX'Cit = 


= S s 


chirr 


ac ter is 


= at 5 


/* save 


+■ r, n ' 
■j ’■■■• \-\ ■■ 


/ i ~F r,\ m : r~ 



Ox SO) /# keypress was a control key */ 

== " ? ) / * start o f ech o a s *'* B ? etc. * / 

/echo == /* second character of echo in ■"**B ■*/ 



* / 



H £ 



r y "t 



O T; 



w i 13. be e c h o e cl *■ 



O Ti a 1 . 1 . \ ) ? / & 

eay < asc i i L a 11 ) ? 



!!iO 



i o t h a t . p u n c: t u a t i o n 



i f ( p r m o d e = = S ,n ) 
onsome ( ) ? 

else if < p r me* d e == 
on most < ) ; 

J' 

e 3. se 

; /# if key echo is not on we throw character away */ 



/ # r e s t o r e o I ci mode * / 
’ M ? > 



else /* not a key echo? just a plain old character sent to screen */ 

r 

X 

savecho = : ’\ 0 ,n 5 

/■*■ check for space after BACKSPACE used for erasing */ 

if (scoLint == 1 t-.tv. (keys ===== BACKSPACE SS keyz ===== DELETE) ) 
return ? 



/* check for top of screen */ 
temp = gccp(>3 
temp - temp / E56? 



(temp >= 


top ) 




/ •V:- c h e c k 


n 

0 

r 


mode */ 


i f ( 3. c 0 1 


> 0 i : 


reel < MAXCOL) 



/* say only certain 



columns #■/ 



temp = geep ( ) 5 
temp = temp % E56? 
if (temp < Ic.ol IS temp > rcol ) 
return ; 



prechk < a > ? 



\ 


/ 4- 


end if 


( temp >= 1 


bop) 


4- 


]. / * 


end 


big e 1 


se / 






3- / * 


end 


" myscr 


sen" */ 







/ 4- 4- 4. 4. .j*. 4. 4- 4- 4- 4- 4- V- 4 4. 4- 4;- 4- 4- 4i;- 4- 4- 4- -4 4- 4- 4- -4 4- £• 4-* 4 / 



rnystr cpy ( s ? t ) 
char *s? *t ? 



/■». 



:opy t to s? pointer version 



W h i 1 0 ( M- S *+" = *ir t + -b ) 



. .4 4- 4- •£• 4-4- 4- 4- 4- 4- 4*4* -fc * -ft *K“ 4* 4- 4-4- 4- 4-4- / 



char ^number chk < number ) 
char ^number 3 



/* Compli 
return 



ted r out i ne which accepts a string of digits and 
a pointer to their word equivalent „ */ 



O 

ERIC 



stat ic 


char 


do 1 1 ar ? uni t s 


s t a t i c 


char 


t Z EGG 3 3 


static 


char 


Sup ? *wp ? *f 


■ tat i c: 


char 


last? 


- 1 a t i c 


int 


j, ks 



n its? who ]. e Z EG 3 ? f r ac t i on Z EG 3 3 



iei 



if 



return C a sc i i I" 3 ) |S 



< Inumtog 



( n l.i m b e r [03 = = 7 0 7 




number [13 


( n u m b e r C 0 3 = = 7 '& 7 




number [ 1 3 


number [03 == 7 ? 7 






(number [03 ===== 7 $ 7 




number [ 1 3 



exp 1 ode ( t h number ) ; 
return ( t ) ? 

j 

np r “ : number 5 
dollar = *np ? 
if (dollar == 7 $ 7 > 
++np ? 

wp = who lev 
fp = fraction? 
k = 0; 



7 . 7 ) 

? \ o ■ ) 



7 „ 7 && number CS 3 == : 7 \0 7 )> 



wh i 1 e ( -*np ! = 7 \0 7 &*.&: *np ! = 7 . 7 ) 

r 

i. 

i f ( ^>ip == ? h ? ) 

jr 

L 

if ( >:■ ( i~i p + i) < ’O’ ! ! *(np + S) < *0* ! ' *(np + 3) 
! ! <*<np + 4) >= ’O’ && * < np + 4) <= ’<?’)) 

\ 

exp 1 ode ( t ? number ) 5 
return C t ) ; 



*wp+-+- = *np ? 
++k ; 



++np ? 

s /#■ end while *•/ 

last = *np ; 

*wp = "NO"; 
i = 0; 

if ( #np === 7 \0 7 ) 

*fp - 7 \o 7 ? 
el se 

r 

\ 

++np 5 

w h i 1 e < * - f pi + ■ + - *• n p + + ) 

r 

K . 

i f ( * ( f p - 1 > < 7 0 7 5 

r 

\ 

e >' p 1 o d e ( t ? nu mb er ) ? 
return ( t ) ? 




02 



if (dollar ===== 7 $ 7 && 

{ 

e>:plode( 1 9 nu mb er ) ; 
return < t > 5 
I - 

*t = ** \ 0 =■ IS 

wp = whole; 
uni t s == 7 7 ? 






do 



switch (k) 



O 

EKIC 



case 


1 S 




case 


C\. » 




c a se 


*? a 




i f 


( wp ! = whole 


&& *Wp ===== 7 0 7 ) 




brea k ; 




if 


( wp != whole 


&:&: * ( Wp - 1 ) = 




break ; 




if 


( k ===== 1 ) 






units = *wp ; 




my b t rcat<t?digit 


5 C *wp - 7 0 7 II ) ; 


if 


(k ===== 4) 






mystrcat ( t «. " 


thousand 11 ) ; 


if 


<k ===== 7) 






mystrcat < t ? " 


m i 1 1 i on ” ) 5 


hr 


eak ? 




case 


E: 




case 


5 s 




c ase 


8s 




if 


( wp ! = whole 


&& *wp ===== 7 0 7 ) 




break 5 




i f 

r 


( *wp ===== 7 1 7 ) 




' k . 


mystrcat ( t * teens C* ( wpn-1 ) - 7 




if (k ===== 5) 






mystrcat ( t * 


" thousand " ) ? 



if (k ===== 3) 

mystrcat < t * '* million ” ) ; 



b 1 se 














my 


str 


cat < t 


«. ten 


si • 


*Wp - 


’ 0 7 3 ) 5 


if 

r 


( •* 


■ ( wp + 


1 ) 


~ ~ 


7 0 7 ) 






if 


<k == 


5) 












my str 


cat < 


t , 


” thousand “ 




if 


<k ===== 


3) 












my str 


cat ( 


t «. 


" milli 


Lon ” > 



break ; 

case 3 : 
case 6s 

case ? : * 

i f ( wp ! == who 1 e && *wp == 7 0 7 ) 
break ; 

my s t r c a t ( t ? d i q i t s C *wp - 7 0 7 3 ) ; 
mystrcat ( 1 5 11 hundred M ) I 
break ; 



7 1 7 ) 



:> 7 : > ; 



1S3 



clef aul t s 
break ? 



j ■ / * end switch # / 

— k ; 

++WP ? 

3- wh i 1 e ( *wp ! = 7 \ 0 7 ) 5 /* end do 

fp = fraction? 
if (doll ar “= 7 $ 7 ) 

r 

"l 

i f ( *who 1 e ! = 7 \0 7 ) 

.r 

v. 

i f ( uni ts == 7 1 7 ) 

my s t r c a t ( t ? '* d o 1 3. ar " ) ? 
else 

my s t rcat(t j" doll ar s '* ) ; 



i f ( *f p 7 \0 7 ) 

r 

L 

if ( last « ' . ' > 

mystrcat ( t j asc i i C ’ . ’ 1 ) j 
return ( t ) ; 



i f < *f p == ’ 0 ’ f p + 1 ) == ’ 0 ’ ) 

r 

if (*whole =- 7 \0 7 ) 

return( " zero cents ** ) ; 
if (*whole == 7 0 7 o:&: *(wHole+l> = 
return ( ** zero dollars and zer 
return ( t ) 5 



if (*whole !« 7 \0 7 ) 

mystrcat' t P " and “ ) ; 
if ( *fp == 7 1 7 ) 

{ 

mystrcat ( t ? teens l * ( f p + 1 ) - 7 0 7 3 ) ; 
mystrcat < t > 11 cents " ) 5 
return ( t > ; 



if (*fp != 7 0 7 ) 

mystrcat ( t •> tens C *fp - 7 0 7 3>; 

++f p ; 

if (*fp != 7 0 7 ) 

mystrcat ( t ? d i g i ts C *f p - 7 0 7 3 ) ; 
if ( * < f D “ 1 ) == 7 0 7 *f p — 7 1 7 ) 

mystrcat ( t * " cent " ) 5 
else 

mystrcat (t s " cents M ) ; 
return < t ) ; 

/* end if (dollar ===== 7 % 7 ) */ 



if 

C 



<*fp «= 7 \ 0 7 ) 



O i 



ERIC 



( last == 7 . 7 ) 

mystrcat ( t ? as 
return ( t ) ? 



;-ci.i[ 7 . 7 3) 



7 \ 0 7 ) 
cents" 



po int " ) 5 



e l s e 

mys treat < t ? " 

do 

r 

\ 

my 5 treat ( t ? d i g i t si *f p - ' 0 ? D ) ;. 
++f p ; 

I:- while <*f p != ? \0 ? )5 
return ( t > ? 



/* end " number ch k ” */ 



/***•) 



prechk < a ) 
char a; 

r 

/*■ Are we saying each character? */ 

if ( talkmode == LETTERKEY !! talkmode == BRAVOKEY) 

r 

X 

if (rpunctog) /* count repeated punctuation */ 

a = ere ( a ) 5 
say ( asc i i [ a ] ) 5 



else 

r 

L 

if (cap tc>g &■.& a>= ’A" £>:&■. a <= ’2’) 

r 

X 

saychk (FAKESPACE) ; 
saychk ( ? c ? ) $ 
saychk < ? a ? ) ; 
saych k < ? p ? ) S 
saychk (FAKESPACE) ; 



a = TOLOWER (a) ; 
saychk < a ) ; 

•> 

j - 

> /*end of prechk*/ 



read i n ( ) 

/* reads in ctab and utah pairs (custom pronunciation) until end of file */ 



stat ic int i ? j ? k 5 
static char stringC30]; 

my open ( ) ; 



i =05 

do /* read in ctab 



ctabCi] = 
wh i 1 e ( < k 



ERJC if 



break ; 



sp ; 

= mygetc < ) > 



word */ 



! = EOF) 



/* pass end of line */ 



EOF) 
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/* get ctab entry */ 

*sp++ « TOLOWER(k); 
if ( sp >~ se) 
return ( i+1 ) 5 

wh i 1 e ( i k “ mygetc ( ) ) ! ~ ? ? ) 



*sp++ — ? \0 ? ? 
if ( sp > = se) 
return ( i+i ) 5 

/* get utab word or phrase (may be null string)*/ 



while((k - mygetcO) >~ *“ * > /* read right hand side */ 

r 

L 

*sp++ - k; 
if ( sp >*= se) 
return ( i ) ; 



if (j > 48) /* we just put in 49th' character */ 

r 

\. 

say ( "custom table entry"); 
i toa < i ..string) ; 
say ( numberch k ( str i ng ) ) ; 
say ( " too 1 ong " ) ; 

while ( mygetc () >« ? ? ) /* throw away rest of too long line */ 



— sp ; /* we will zap 49th character */ 

break 5 



*sp++ = ? \0 ? ; 
if ( sp >= se ) 
return ( i ) ; 

3* while (TRUE)? /* end do */ 



ltab = i ; /* this will be length of table for later binary search */ 
return(O); /*all entries fit in (some may be truncated)*/ 

/* end "read in" */ 



/* Reads in synthesizer control parameters from file "synth". */ 



r 

L 



*sp++ = TOLOWER ( k ) ; 
if ( sp >~ se) 



return ( i+1 ) ; 



s 



cz 



PS 



j - o; 






/ 




rsyn ( ) 



r 



static int i ; 
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for 


( i = 0 ? i 


•=s Eo 5 i •+••+• ) 




vo lstr C i 3 


= synstr ( ) ; 


for 


( i = 0 ; i 


< E6; i++) 




ratestr C i 


3 = synstr ( } ; 


for 


( i = 0 ; i 


< E6 ; i ++ ) 




f pstr C i 3 


= synstr ( ) ; 


for 


< i = 0 ; i 


< E£> ; i ++ ) 




ipstr C i 3 


= synstr ( ) ; 



if (sygetcO !« EOF) 

say ( " too many entries in file sinth " > 

} /* end "rsyn" *■/ 




saychk ( a ) 



char a? 

/* This routine is the heart of the code. It 
character and handles it according to what 
and what type of character it is. 



checks every screen 
mode we have been in 



The mode is indicated by the variable “ in'S which can take on 
3 possible values: 

7 P 7 for punctuation; 

7 A 7 for alphabetic; 

7 N 7 for numeric. 



static char phraseC 1503 ? word C 503 ; 
static char *wp «. *ap ; 



if (a == 7 \001 7 > /* zapping the buffer */ 

r 

\ 

wp = word; 

*wp = 51 \0 7 ; 

■^phrase = 7 \0 7 ; 



if (rpunctog && talkmode ! = SKIMKEY) /* count repeated punctuation * 

a = src(a) ! 

if ( mystr len ( word ) > AS) /# ridiculously long word */ 

r 

say ( phrase ) ; 

^phrase = 7 NO 7 ; 
say ( word ) ; 

*word = 7 NO 7 ; 



if (in == 7 F ,7 > /> previously in punctuation mode ■*/ 

,r 

if ( ALFHABET I C < a ) !! (prmode ===== 7 S 7 && (a ===== 7 N 7 7 I! £ 



7 - 7 ) ) > 



in = 7 A 7 ; 
wp = word < 
*wp ++ = a! 

:RJC returns 



/* now alphabetic mode */ 



1 I 
1 ? 






if < NUMERIC* a > 

r 

X 

i n * "NT ? 
wp = word s 
*wp++ ~ a; 
return ; 



a « 



/* now numeric mode */ 



/* Neither alphabetic nor numeric so must be punctuation characters 

if (talkmode != SKIMKEY) /* SKIMKEY means only speak big words ♦ / 
say ( asc i i E a 3 > ; 

*phrase = *\Q*$ 

retur n ; 

3- /* end if (in == ? P ' ) is. previously in punct . mode */ 

if (in == ’A’} /* previously in alphabetic mode */ 

r 

L 

if (ALPHABETIC* a) !! (prmode == ’S’ && ( a == *\” !! a == ’-’))) 

jr 

L 

*wp++ =s a? 
return ; 

■v 

J" 

else 

jr 

♦wp « *\Q*i 

if (custog) /♦ user wants custom pronunciation */ 

userchk ( word ) ; 



if ( mystr len ( word ) < 25) 
abbrchk ( word ) 5 

if (talkmode «« SKIMKEY) 

r 

X 

if ( mystr len ( word ) < 7) 

♦word « ? \ 0 ? ; 
e 1 se 

mystr cat ( word ? " *' ) ; 

T 

J' 

if (( mystr len ( wp ) + mystr len ( phrase ) > >= siseof (phrase) ) 

r 

X 

say ( phrase ) ? 

♦phrase = ? \0 ? ; 



mystr cat (phrase ? word ) ; 

wp = word; /♦ reinitialise wp to start of word ♦ / 
if (a ===== ? ) 

r 

V 

if (talkmode != SKIMKEY) 

mystrcat ( phrase ? asc i i C ’ ’ ] ) ; 

return ; 



if (a == ’-’ ) 

O C 

EKLC if (talkmode != SKIMKEY) 

MiBimiw mystrcat ( phrase <■ asc. i i C ’ — ’ 3 ) ; 
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$ ! ' a 



if ( NUMERIC < a ) ! S a *« 



in* 7 N 7 5 
*wp++ = aj 



return ; 



/* All other eases fail so we have a punctuation character: */ 

in * 7 P 7 ? /* now in punct mode */ 

say ( phrase ) ; 

^phrase == 'NO 7 ; 

if (talkmode !* SKIMKEY ) 
say ( asc i i Ea 3 ) 5 
return; 



/* end else */ 

/* end if (in == 7 A 7 )? ie. previously in alphabetic mode */ 



/* Only other choice is (in ==■ 7 N ? ) j ie. previously in numeric mode */ 
if ( NUMERIC ( a ) !! a « 7 $ 7 i! a *« 7 . 7 \ ! a 7 * 7 ) 

r 

L 

*wp++ = a ; 
return ; 



else 

•C 

*wp « 7 \ 0 7 5 

if (talkmode ! = SKIMKEY) 
wp = numbered k (word ) ; 

if ( (mystr len(wp ) + mystr len ( phrase > ) > = sizeef (phrase) ) 

r 

X 

say ( phrase ) ; 

^phrase = 7 \ 0 7 ; 



mystr cat ( phrase ? wp ) ; 
wp = word; 

if < a == 7 7 ) 

r 

X 

if (talkmode != SKIMKEY) 

mystreat (phrase ? asc i i C ’ ’ 1 ) j 

return \ 



if ( ALPHABET I C ( a ) !i (prmode == 'S' &S= (a == ’ \ ’ 

r 

X 

in = ? A 7 ; /* now in alphabetic mode #/ 




^•wp++ = a; 
return ; 



/* All previous 
in « 7 P 7 ; 



tests fail so we have a punctuation 



i n p u n c 1 u a t i o n m o d e * / 




a « 7 - 7 ) ) ) 



character */ 



/# now 



•sphrase « '\0'j 
if (talkmc.de != SKIMKEY) 
say < asc i i C a 3 ) 5 
r etur n j 

/* end else */ 

/* end "saychk" */ 



/#*#**** ###****# ***#•■**■*■ ■*■******#*#***■>?■# ■**#*#/ 
setup ( ) 

/* Initialize variables arid default modes. 

Called only by subroutine " init" on boot-up. 



/* Variables associated with what we read on the screens */ 
top = 0; 

markcol = MAX COL + i; 

1 c o 1 = 0 ; 
reel = MAX COL 5 

/■* Initialize modes represented by toggles: */ 

rpunctog = FALSE; 
he ip tog - FALSE? 
pa use tog = FALSE; 
numtog = TRUE; 
custog = TRUE; 
cap tog = FALSE; 
echo tog = TRUE; 
synch tog = FALSE; 
in ton tog = TRUE; 

/*• Initialize other modes: */ 

talkmode = NQRMALKEY ; 
pr mode = SOMEKEY; 

pitch = 7 M : ' - "A 7 ; /•* must be set for possible use in setinton<> */ 

/* read synthesizer specific parameters & initialize synthesizer: */ 

syopen ( ) ; 
rsyn<); 

send ( ini tstr ) ; 

/* initialize for "some" punctuation and normal letters (no caps): * 
onsome ( ) ; 
of f bravo ( ) ; 

Q p = space; 



r 



static int temp; 
static int sC303? 



i n = 
srcct 
o 1 dc 



? \ 
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say ( "ran out of space for user table at entry" ) ? 
i toa ( temp ? s ) ? 



say ( numberchk ( s ) ) 5 

Itab = temp - 1; /* discard offending entry */ 

-i 

j 

shel 1 ( c tab ,utab ? Itab > 5 
/* end "set up" */ 



/ tf - 






she ll(sjtjn) 
char *s C 1 * *t C 3 5 
i n t n ; 

/* Sort table of pointers to chars s and related table t ? 
both of length n */ 



static int gap ? i*j5 
static char *temp? *templ; 



for (gap = n/S; gap > 0; gap /« E) 
for (i = gap; i < n? i++) 



■ o r 



< J 



gap* j 



05 j -= gap) 



if ( myst r cmp ( s C j 1 9 s C j +gap I ) <= 0) 

break ; 

temp = sC j 1 ; 
temp 1 - t C j ] ; 
sC j 3 = sC j + gap ] ; 
tC j 1 « t [ j + gap] ; 
s C j •+■ gap ] = temp 5 
tCj + gap] = tempi; 



/* end u shel 1 “ */ 



/***********************#***********•/ 

char *syalloc(n) /* return pointer to n characters*/ 



if (sbfp + n < sbfe) /* fits */ 

r 

sbfp += n ; 
return(sbfp - n); 

t 

J' 

else return ( NULL ) 5 




sygetc() /* get a character from file "synth 11 */ 

r 

static int z 5 
z = syread ( ) ? 
if ( z « ? ) 

jr 

Q z = syread () - ’O'; 

ERIC 2 10*z + syread <) 
z — i o ‘st 1 z “J" s v read ( ) 




if (z == 26) 



z = EOF; 
return ( z ) s 






/■* end "sygetc" ■*/ 




char *synstr ( ) 



/* read in a line from file "synth* 1 */ 



static char .*s? 
static char t C 30 1 ; 
static int i * k 5 
static char stringC30] 



i 



while ( ( k = sygetc()) i = ? \n ? k != EOF) 

tci++: = ks 
if <k == EOF) 

r 

V 

say ( *' missing entry in file s i nth " ) ; 
return (NULL) 5 



t C i ] = ? \0 ? 5 
s = syal loc ( i+1 ) S 
mystrcpy ( s ? t ) ? 
return < s > ; 

y /# end “synstr" */ 



ERIC 
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/* file: KEY.C 

last edited by pm at 
410s 16 a.m„? May 17, 1985* 

*/ 



/* This file contains the major routines associated with 

"vima" status = 1? ie. "mykey" and the major subroutines 
it calls. 

*/ 



p. g. ^ 

mykey ( ) 

/# This routine is called only by vima and only when vima is called 
with status == 1 (meaning the user program wants a key). 

"Mykey" loops until a key has been pressed. Then it looks at the 
key in the keyboard buffer without removing it. 

If it is one of our command keys? it removes it from the buffer 
and handles it. 

This process continues until the user presses an ordinary key? 
destined for the user's program. At that point? we store the key 
in “keys" (for later use by "myscreen" ) and return (via "vima" and 
our assembly language code) to the BIOS routine which will get 
the character and pass it to the user program. 

*/ 



s t a t i c i n t k ? 

while ((k = zkeyO) == 855) /* wait until a key is pressed */ 



do 



/* wait for key & process our commands */ 



if ( k == lineky) /* screen review mode */ 
1 i nerev ( ) ? 



if (k ==* modeky) 



/* normal command mode */ 



gkey(); /* remove command key from buffer */ 
modeset ( ) ? 

j' 

while ((k = zkey()> == 855) /* wait until a key is pressed ■*/ 

? 

y while (k == lineky !! k == modeky)? 



/* At this point? the keyboard buffer holds a key to be transferred 
to the user program. 

*/ 



if (k == BACKSPACE !! k == DELETE) 

kback<)? /■* save what might get erased. */ 

O 

ERIC /z = k? /* save for "myscreen" to check */ 

MiaiM Lount = 0? /* nothing has appeared on screen yet — 



H 



II 



■tf- 



for 



y /■* end "iiiykey 11 #/ 

/#**« ******** ■***************##•*#****/ 
1 inerev( ) 

/*• Implements screen review mode. *■/ 

jr 

static int k?c; 




gkey()$ /* remove lineky from buffer */ 

if (he Ip tog ) 

say < "review" ) ; 

movecursor ( ) 5 /■* audio cursor = video cursor */ 

/* get commands and perform them: */ 

while ((k - gkeyO) 1= ESCKEY ) 

£ 

k = TOUPPER ( k ) 5 
switch (k) 

r 

V 



case AUDIQKEY: /* speak: current audio cursor 

if (helptog) 

say( "audio cursor at" ) ; 
and i ©cursor ( ) 5 
b r e a k ? 



position */ 




case BACKKEY: /* move audio cursor to previously saved position */ 

if ( helptog ) 

say ( "back " ) ; 
review ( ) ; 
break ; 



case DOWNKEYs /* move cursor down 1 line */ 
i f ( he 1 p tog ) 
say ( "down" ) ; 
movedown< ) ; 
break 5 

case FINDKEY: /* find specified string */ 

if (helptog) 

say ( "find " ) 5 
search ( ) 5 
break 5 



case LEFTKEY: /* move cursor 

if (helptog) 

say ( " lef t " ) ? 
if (column > lcol) 

r 

if (talkmode == LETTERKEY ! 

r 

c 

prechk ( qetscr ( ) ) ; 

— co 1 umn 5 

T 

J 

else 

slastword ( ) ? 

J' 

else 

say ("start of line" >5 
break ; 



1 unit (char /word) to left 



I talkmode ===== BRAVQKEY ) 



say 



it */ 



move 



audio cu r s o r to st a r t o f g i v e n 3 . i n e * / 






case LINEKEY: 
if < h e 1 p t o g ) 

say ( " 1 ine" > ; 
c = gkevO; 
c = TOUPF'ER (c) 5 
if (c >= top + ’ A ’ &:£, c <= !’fi J + MAXLINE)) 

■c 

3. i ne = c - ? A 3 5 
if (helptog) 

say ( asc i i Cc 3 ) 5 /■* line letter */ 

column = Icol 5 

n 

j’ 

e 1 se 

say (“illegal 1 ire" ) 5 
if (c < top + ? A ? ) 

say ( “above top " ) 5 

break 5 



case MARKKEY : /■* save current position of audio cursor •*/ 

if (helptog) 

say ( “mark “ ) ? 
marker ( ) ? 
break 5 

case RESTKEY: /* say rest of line &•. move cursor to next line */ 

if (helptog) 

say (“rest of line" >5 
if (col umn < = rcol ) 
sayrest ( ) $ 
e 1 se 

say (“at end")? 
break 5 

case RIGHTKEY: /* move cursor 1 unit (char /word) to right Z-. say it */ 

if (helptog) 

say ( “r ight “ ) 5 

if (talkmode == LETTERKEY !! talkmode *= BRAVOKEY) 

r 

prechk ( get scr ( ) ) ; 

++co 1 umn U 

s 

e 1 se 

saynex two r d ( ) ; 
if (column > rcol) 

r 

■\. 

send ( pauses tr ) 5 
say ( “ 1 i ne done “ ) ; 
column » Icol 5 

j 

break 5 



case UPKEY : /*■ move cursor up 1 line *■/ 

if (helptog) 
say ( "up." ) 5 
moveup ( ) ; 
break 5 




def aul 1 5 

if (k «== modeky) 



modeset ( ) ? 
if (column < lcol 



command key to 



{ column > rco 



access other set of commands 



! ! 1 i ne < top ) 



*/ 



X. 



co lumn 



3 . c o 1 ; 
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say ("audio cursor now out of bounds" >5 
say < "moving audio cursor to top left"); 

** 

-i 

J' 

else if ( k > 0 && k < 27 ) / * control chars */ 

r 

if ( k == 31 ! k == 8 1 ! k == 13 ! ! k == modeky) 
say (“cannot use that key") 5 
else 

r 

lineky = k 5 
if (help tog) 

r 

V 

say( "review now control" ) ? 
say(alphaCk - 11 +4)5 

j 

J' 

*> 

J 

else /* not control char */ 
say ( " i 1 legal key" ) 5 
break? 

3- /* end switch */ 

3- /■* end while */ 

if (he Ip tog) 

say ( " end rev i ew" ) ? 

/* end "line-rev” */ 




mo deset ( ) 

/*- Changes modes as specified by user command- */ 



static int k ? 

if ( help tog ) 

say ( "mode" > 5 

k = gkey(); /* get command letter */ 

k = TOUPPER ( k ) ? 



sw i tch ( k ) 



case ALLKEY: /* pronounce all punctuation */ 



if ( h e 3. p t o g ) 

say ("all punctuation" ) ? 
prmode = k? 

onali<>? /* change entries in array "ascii" */ 

break ; 

case BRAVOKEY : /* spell letters using 'alpha' ? 'bravo' ? 

if ( helptog ) 

say ( "bravo" > 5 
talkmode = k; 

onbravo()5 /* change entries in array "ascii" •*/ 

^ break? 



ERIC 



etc . */ 



CAPKEY 



if (cap tog) 

r 

V 

if (he Ip tog) 

say ( "capitals on" ) ; 

upcaseO; /* change entries in array " asc 11 " */ 

•v. 

J 

else 

r 

if (helptog) 

say ( "capital s off"); 
lowcasel ) ; 

-i 

b r eak ; 

case CQLKEYs /*• only speak certain columns */ 

i f ( h e 3. | j tog) 

say ( " co 1 umn " ) 5 
setcoK ) ? 
break ; 

case CURSKEY s /*• speak cursor position */ 

if(helptog) 

say ( "video cursor at" > 5 
saycur sor ( ) 5 
br 0 a k 5 

case CUSTKEY s /* search user table for custom pronunciations */ 

custog = ! custog; 
if (helptctg) 
i 

say ( "custom" ) ; 
if (custog) 
say ( " on" > ; 
else 

say ( "off " ) 5 

■> 

j - 

b r e a k *5 

case ECHOKEY: /* echo key presses */ 

echotog = lechotog? 
if (helptog ) 

r 

V 

say ( "key echo" ) ; 
if (echotog) 
say ( "on" ) ; 
else 

say ( "off " > 5 

j 

b r e a k 5 

case HELPKEY: /* say effect of commands as user gives them */ 

helptog = Ihelptog? 
if (helptog ) 

say ( "help on" ) ; 
else 

say ("help off"); 
br eak ; 
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:ase INTONKEYs /* flat 
intontog = ! intontog; 
set inton ( ) ; 
if (helptog ) 



vs. intoned ■*/ 



O 

me 



say ( "intonation 1 
if ( intontog > 



) 



b 1 se 

say < "off" 3 ; 

-i 

.y 

break ; 

case LETTERKEYs /* spell using regular letter names #■/ 
if (helptog) 

say ( " letter " ) ? 
talkmode = k? 

offbravoO? /* change entries in array "ascii " */ 

break ? 

case MOSTKEY: /* pronounce most punctuation ■*/ 

if (helptog) 

say< "most punctuation" ) 5 
prmode = k 5 

onmostO? /* change entries in array "ascii" */ 

break? 

case NORMALKEY : /*• normal pronunciation? ie. words *V 

if ( helptog ) 

say < "norma 1 " ) ; 
talkmode = k? 

offbravoO? /* change entries in array "ascii" */ 

break ? 

case NUMKEY : /•* pronounce digits as either numbers or digits */ 

numtog = ! numtog? 
if ( helptog ) 

r 

if (numtog) 

say ( "numbers" ) ? 
else 

say ("digits")? 

j' 

b r e a k. ? 

case PAUSEKEYs /*■ pause between words * / 
pausetog = ! pausetog? 
if ( helptog ) 

r 

say ( "pause" ) ; 
if (pausetog) 
say ( "on" ) ; 
else 

say ( "off" ) ? 

j' 

break ? 



case PITCHKEY: /* change pitch of synthesizer voice ■*/ 

if (helptog) 

say ( "pitch" ) ? 
se t p i tch ( ) ? 
break? 

case RATEKEY: /* change synthesizer speech rate */ 

if (helptog ) 

say ( "rate" ) ? 
setr ate ( ) ? 
break ? 

case RPUNCKEY s /* count repeating punctuation */ 

^ r p unc tog = ! r p unc t o g ? 

ERIC if (helptog) 

Is 



if ( rp unc tog ) 

S cs y \ On ) ? 
else 

say ( “off" ) ? 



break ; 

case SKIMKEYs 
if (he Ip tog) 

say ( "skim" ) ? 
talkmode = k> 
of f brave ( ) 5 
break ; 



case SDMEKEYs 
if (he Ip tog ) 

say < "some punc tuat ion" ) 5 
prmode = k; 
onsome ( ) ? 
break ? 



/* only pronounce words at least 7 letters long 

/* change entries in array "ascii" */ 

/* pronounce some punctuation */ 



case TOPKEY s 
if (helptog) 
say < "top" ) ? 
settop ( ) ; 
break ? 



/■* change entries in array "ascii" *V 
/* specify top line of screen to be spoken */ 



case VOLKEYs 
if (helptog) 

say ( "volume" ) ; 
set vo 1 ( ) ; 
break 5 



/* change synthesizer volume *■/ 



: ase ZAPKEY : 
zap ( ) s 



/* empty speech buffer */ 



if (helptog) 

say ( " c lear buf f er " ) ; 
break? 

def aul t : 

if (k >0 &&: k < £7) /*■ control char means new command char *V 



if <k 



n 1 1 



k ===== S J ! k ===== 13 ! 5 k 



1 ineky ) 



say ( "cannot use that key" ) ? 
else 

r 

V 

modeky = k? 
if ( helptog ) 

r 

v. 

say ( "now centre* 1 " ) 5 
say ( alpha Ck - 13 + A ) 5 



e 1 se 

say ("illegal key " ) ; 
h r e a k 5 

/+:■ end switch */ 

/* end "modeset" */ 



JL * i 



& 

me 



Major routines (in alphabetical order) needed to implement 



aud iocursor ( ) 



static char string [50 13 5 

say ( asc i i [ ? A ? + 1 i ne 3 ) ? 
i to a (col umn » str i ng ) ; 
say ( number chk ( str i ng ) ) ; 

/ ft $-&&.*** 

1 owcase ( ) 



/* turns off spoken indication of upper case */ 



static i n t i 3 

if (talkmode ===== BRAVOKEY ) 

for (i = 'A"; i < = ? Z i++) 

asciiCi] = bravo C i - ? A ? 3 +4; 

else 

for (i = "A"? i <= *Z 9 i i++) 

asciiC. i 3 = alphaC i — * A *’ 3 + 4; 

/* end 11 1 owcase " *■/ 



marker ( ) 



mar k col == c o 1 umn ? 
mark line = line; 



moved own ( ) 



column = lcol; 



if (line ===== MAXLINE) 

say ("at the bottom " ) 5 
el se 

++ 1 i ne ? 



/ *- -¥■ *- -#* •; 



moveup 



i 1 



column 



1 c o 1 



if (line == top) 

say ("at the top"); 

ERIC 
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i 1 ne ; 



■&¥: # # ***********#***■*■#■******■/ 



of f bravo ( ) 

/• 

X 

static i n t i 5 
if (captog) 

r 

X 

for (i = ’A’; i <= ’Z'i i++> 

r 

L 

ascii [i] = alpha[i- 7 A 7 I!S 
ascii Ci+3S1 = alphaC i - 7 A 7 1 + A s 



else 

for (i = 7 A 7 s i <= =* Z ^ h i++> 

asc i i C i+321 = ascii CiU = alphaC i~ 7 A 7 ] + A S 



/* end "off bravo" */ 



■****/ 



onallO 

/* all punctuation pronounced */ 

r 

X 

onmost ( ) 5 

ascii COxSOD = " space " ; 

■v 

J' 

/***■#•*# ********* ** ************#**********/ 
onbravo ( ) 

/# initiates alpha bravo pronunciation of letters */ 

r 

X 

static int i ; 
if (captog) 

X 

for (i = 7 A 7 ; i •*> 7 Z 7 ; i++) 

X 

asciiCil = bravo C i- 7 A 7 ] 5 

asc i i C i +32] - bravo C i- 7 A 7 ] + As 



else 

for (i = 7 A 7 ? i <> 7 Z 7 ? i++> 

asc i 1 C i-s-32 3 = asciiCil = bravo II i — 7 A 7 1 ■+• AS 



/* end "onbravo" */ 



onmost ( ) 



O 

^RIC cii[ ? ] " ” question mark 11 5 

i i C 7 ! 7 U = " e>:c lamat ion po int 



H 
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a sc i 


i Z 




) 




3 


= 


asc i 


i Z 


? 




? 


3 


=2 


asc i 


iC 


? 


- 


!* 


3 


= 


asc i 


i [ 


!* 


r 


? 


3 


= 


asci 


i Z 


!* 


y 


? 


3 


= 


asc i 


i Z 


? 


c 


? 


3 


= 


asc i 


i [ 


5* 


3 


5* 


3 


= 


asc i 


i [ 


5* 






3 


= 


asc i 


it 


? 


- 


? 


3 


= 


asc i 


i [ 


5* 


9 


? 


3 


= 


asc i 


i [ 


S' 


II 


? 


3 


= 


asc i 


i [ 


5* 


\ 


? 


7 3 


= 


asc i 


i [ 


S' 


*• 


S' 


3 


= 


asc i 


i [ 


? 


1 

1 


? 


3 


= 


asc i 


i Z 


5* 


\ 


\ 


? 3 




asc i 


i [ 


5* 


9 


5* 


3 


= 


asc i 


i [ 




. 




3 


= 


asc i 


i CO 




SO 3 


ss 



right paren "S 
under 1 ins " ? 
dash " ; 
left brace " ? 
right brace "? 
left bracket "5 
right bracket " 
t i Ida 11 ; 
colon " ; 
semicolon 11 ; 
quote 11 ; 

apostrophe "5 
grave accent " ? 
vertical line 11 
backslash " ; 
comma " ; 
period '* ; 



/* end “onmost" */ 






onsome( ) 



/* only punctuation pronounced is */ 



asc i i 


t ? 


7 


7 3 




sss 


it 


ii 


9 




asc i i 


C 7 


j 


7 3 




as 


it 


ii 


? 




asci i 


[ 7 


( 


7 3 




= 


it 


ii 


9 




asc i i 


c 7 


) 


7 3 




as 


n 


it 


9 




asc i i 


[ ■- 




7 3 




SB 


it 


ti 


? 




asc i i 


C •- 


- 


7 3 




as 


it 


ti 


9 




asc i i 


[ 7 


r 

t 


7 3 




as 


ti 


it 


9 




asc i i 


[ 7 


y. 


7 3 




as 


ti 


ii 


9 




asc i i 


[ 7 


[ 


7 3 




= 


it 


H 


? 




asc i i 


[ 7 


3 


7 3 




as 


it 


II 


9 




asc i i 


C 7 


f'w 


7 3 




= 


it 


II 


9 




asc i i 


C 7 


; 


7 3 




= 


ti 


II 


9 




asc i i 


C 7 


9 


7 3 




= 


it 


M 


9 




asc i i 


C 7 


H 


7 3 




SB 


it 


II 


? 




asc i i 


[ 7 


\ 




3 


SB 


it 


\ 


? 


II m 
9 


asc i i 


[ 7 


i; 


7 3 




=s 


ii 


II 


9 




asc i i 


[ 7 


1 

t 


7 3 




= 


ii 


II 


9 




asc i i 


[ 7 


\ 


\ ? 


3 


as 


ii 




II 


9 


asc i i 


[ 


9 


7 3 




= 


ti 


It 


9 




asc i i. 


[ 7 


• 


7 3 




as 


ti 


II 


5 




asc i i 


C 0 >; 


SO 3 


= 


it 




it 


? 



/* end "onsome" */ 



review( ) 



if (markcol < Icol i! mark col 
•C 

say ( "out of bounds" ) ; 
retur n ; 



O 

ERIC 

himiiffBKiaaaa 



lumn 
ne = 



= marked? 
mar k 1 i ne ? 



red 



mar k 1 i ne 



< top) 
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^ 4*. 4 # 4* ## # 4 (■ 4T r g. Air -K* ¥: *: / 



I 

I 



saycursor* < ) 

/*■ say position of cursor */ 



static int j! 

static char string! 50 3 5 

char ^number chk ( ) ? 

/* get cursor position with call to machine language program * 
j = gccp ( ) IS / 

say ( a sc i i L A " + j / 256 3 ) 5 /* 1 ine */ 

i to a ( j % 256 s string); 

say ( numberchk ( str ing ) > 5 /* column */ 

/*• end "saycursor" */ 



saynex tword < ) 

/* assumes that on entry line and column are legal? i.e. betwee 
top and MAXLINE and between lcol and reel respectively 

*/ 



stat ic char str ing UMAX COL +4 3 ? 
static char *stp? 
static char c 5 

stp = string? 

if <! alphanumeric < c = getscr ( ) ) ) 

r 

"l 

do 

r 

*stp++ = c ; 

++co 1 umn 5 

3- while (column <= rcol && ! alphanumeric (c = getscrO ) ) ! 

\ 

j 

else 

r 

while (column <== rcol && alphanumeric (c = getscr ( ) ) ) 

r 

L 

#stp++ = c 5 
++co 1 umn ; 



#stp = \0 7 $ 

stp = string? 
while <*stp != ’XO 7 ) 
prechk ( *stp++ ) ? 
prechk ( ? \ 0 ' ) ? 

1 /# end "saynextword" #/ 

/ 

ERJC rest ( ) 

hfinniiiiffUffTiaaa 




I 

I 



static char stringC813; 
static char *stp ? 

stp = string? 

for ( ? col umn < = reals col umn++ ) 
*stp++ = getscr ( ) ? 



# s t p = ? \ 0 ? 9 
stp = string? 



while (*stp ! = ''VO") 
prechk < *stp++ ) 5 

prechk < ? \0 ? ) ? 

column - lcol? 



'* end "sayrest" */ 



{•**■**/ 



say who 1 e 1 i ne ( ) 

r 

'u 

static char str i ng C MAXCDL+4 3 ; 
static char *stp ? 

stp = string? 

for (column = lcol ? column < = rcol f column++) 
#stp++ = getscr ( ) ? 

*stp = ’VO’S 
stp = string? 

while <*stp ! = *\Q*) 
prechk < *stp •+••+• ) ? 



prechk ( ? \0 ? ) ? 



/# end "saywho lei ine' 1 */ 



search ( ) 

/•* get string? search for it? and say line containing it 

r 

i 

static char sstr ir»glI203 3 
static i n t i ? j ? k ? 1 ? c 5 
static char *ssp ? 

i = 0; 

while (<k = gkeyO) != NEWLINE && i < 1?) 
sstr ingt i++3 = k? 

if (i =s=r. 19) /# throw away extra keys Lip to delimiter 

wh i 1 e ( g key ( ) ! = NEWL INE) 

? 

sstr ing C i 3 = ? \0’ ? 

Q ;y ( sstr i ng > ? 

ERLC_ „ . 

tr O p ? 
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whiled <- MAX LINE) 

r 

X 

c = l c o l ; 

while (c <= (rco! - i + 1)> 
•C 

j = c ; 

ssp = sstringj 



I 



while ( ( getsc <E56*1 + j) */. E56) == frssp) 

r 

v 

j++; 

ssp++; 



if (*s5p == ’AO’) 

/* SUCCESS! ! */ 

r 

X 

line - 1 ; 

say who lei i ne ( .) ; 

column ~ c; /* set audio cursor to start of word */ 

/* user presses space bar to look for another instance */ 
/* any other key ends search and is the start of a new ■*/ 
/* command to be interpreted elsewhere */ 

while ( ( k * 2 key ( ) > ===== £55) 

if ( k ! = ’ ? ) 

return; /* return with key still in key buffer */ 
gkey()5 /* get space out of key buffer */ 
c = rcol +3? /* pop out of loop for this line */ 



/* either still looking for first instance or start looking 
/* for next instance */ 

++c 5 

y /* end while (c <= (rcol - i + 1 > > */ 

/■* not on this line — try next line */ 

++1 5 

/* end (while 1 <= MAXLINE) */ 



say ("not found”) ; 

/* end "search" */ 



setco 1 ( ) 

/* set up to read text by columns */ 



static int ltemp? rtemp? 
static char sC30U; 

wh i 1 e ( z k ey ( ) == 255 ) 



ERJC r dkey() 






lnuni} mum; 



NEWLINE) 



1-85 



I 

I 



lcol = 05 
reel = MAX COL; 
if (helptog) 

say ("a 11 columns"); 



else /* get column numbers */ 

r 

if ((Itemp = getnumO) ! = ESCKEY 

Z-.Z-. < 1 num = getnumO) ! = ESCKEY 
Z-.Z ( r temp = getnumO) != ESCKEY 
Z:Z-. (mum = getnumO) != ESCKEY) 

r 

■\. 

Itemp = 10*1 temp + Inuro; 
rtemp = 1 0 *r temp •+* mum? 

if (rtemp O MAXCQL 2 >.&: Itemp <= rtemp) 

r 

\ 

. lcol = Itemp; 
rcol = rtemp; 
if (helptog) 

r % 

v 

say ( "left" ) ; 
i toa ( 1 temp ? s ) ? 
say ( number chk ( s ) ) ; 
say (“right”); 
i toa ( rtemp ? s ) ; 
say ( number chk ( s ) ) ? 

*v 

J 



else /* illegal */ 

r 

v 

say (“you tried to put left column at u ); 

i toa ( 1 temp ? s ) ; 

say ( number chk ( s ) ) 5 

say (“and right column at“); 

i toa ( rtemp ? s ) ? 

say ( numberchk ( s ) ) ? 

if (rtemp > MAX COL) 

say (“right column is too far right”); 
if (Itemp > MAXCQL) 

say (“left column is too far right’*)? 
if (Itemp > rtemp) 

say (“left column may not be to the right of right column 
3- / * end else illegal */ 

3 /* end if Itemp = getnum( ) ? etc. */ 

/* end else column numbers */ 



/* end “setcol” */ 



/** 



set i nton ( ) 



if ( i nton tog ) 

send ( ipstr Cpitch] ) ? 
else 

send ( f pstr Cp i tch 1 ) ; 
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setp i tch ( ) 

r 
\ . 

/* pitch must be global and initialised because it is used in set i nton ( > *•/ 
static int kk; 

kk = gkeyO; 

kk = TOUPF'ER ( kk ) - •’ A ? ; 

if <kk < 0 ! ! kk > £5) 

r 

X 

say ( " i 1 legal p i tch " > 5 
return ; 



pitch = kk 5 

if (intontog) 

send (ipstr [pitch ]) ; 
else 

send ( f pstr Cp i tch ] ) ; 
if (helptog) 

say ( asc i i Cp i tch + -’A 3 ]); 
/* end "setp itch" */ 



setrate( ) 

r 

X 

static int rate; 

rate = gkey ( ) ; 

rate ■ TOUPF'ER < rate > ; 

if (rate < "A 5 !! rate > "Z") 

r 

X 

say ( " i 1 1 eg a 1 r ate" ) ; 
return 5 



send ( r atestr Cr ate- ” A ? ] ) ; 



if (helptog) 

say (ascii Crate]) ; 

/* end "setrate" */ 



settop ( ) 

/* Bets to ignore anything written on designated top screen lines */ 

r 

X 

static int o Id top ; 



o 1 d t o p = top; 

top = gkey ( ) ; 

top = TOUPF'ER (top) - ’A’; 

if (top < 0 !! top > MAXLINE) 

r 

\. 

say <" i 1 legal top"); 

Q top = old top; 

ERIC 

BSSSBffiS 3 ] -f" ( hp3 D tDO ) 
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set vo 1 ( ) 



l 

_ static volume; 

™ volume = gfcey ( ) ; 

volume = TOUPFER ( vo 1 ume ) ; 

( if (volume < ? A ? ! 1 volume > *’2*’ ) 

r 

_ say ("illegal vo 1 ume ’* ) ; 

■ return? 



send ( vo 1 str [ vo 1 ume- ? A ? 3 ) ; 
if ( he 1 p tog ) 

say ( asc i i [ vo 1 ume 3 ) ; 

> /* end "setvol" */ 



s 1 as t word ( ) 



static char 
static char 
static char 



str ingCMAXCOL+43 ? 
*stp ? 
c 5 



stp = string? 



— co 1 Limn ; 

if ( ! a 1 phanumer i c ( c = getscr<>>> 

r 

L 

do 

r 

L 

*stp++ = c ; 

— co 1 umn ? 

y while (column >« lcol ! al phanumer ic (c = getscr ( ) ) ) 



else 

r 

while (column >= lcol ZZ-. alphanumeric (c = getacr ( ) ) ) 

r 

L 

■*stp++ = c ; 

— co 1 umn ? 

"V 
J 

J 

++co 1 umn ; 

*stp = ? \0 ? J 
r ever se ( s t r i ng ) ? 
stp = string; 
while <*stp’ ! = ’NO’ ) 
prechk (^5tp++) ? 
prechk ( ■ \0 ? > ; 

O 

ERIC /■* end "slastword" */ 

hfinniiiiffUffTiaaaa 
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upca5e( > 



I 

/* forces spoken indication of upper case */ 

I 

static i n t i ; 

■ if (talkmode «= BRAVDKEY) 

" for (i = ’A’; i <= ’ Z ’ j i++> 

a sc i i C i ] = br avo C i - ’ A ' 3 5 

■ el se 

| for (i = ’A’; i <= 'Z ! ; i++> 

asciiCi] = alphaC i - ’ A’ 3 ; 



/# #•■***•* *•***■****##***#***#*#*#£*##■##■■*•/ 

zap ( ) 

r V 

v. 

saychk ( ? \001 ? ) 5 
send ( zapstr ) 5 



O 

ERLC 



pm 

i 0 5 1985 



I 

I 



/ +r file: s t s « c 

last edited by 
S s 1 6 p ■ m - s Nay 

*/ 



#inc lude def s « c 
#inc lude main . c 
#inc lude key .c 



UTILITY ROUTINES: 



[■ V -V ■ #■ -K *■ -fc #• -¥r ¥: / 



abbrchk < word ) 
char wordE ] 5 

/* Sees if we have an abbreviation (all consonants). */ 



static char * wp ? *np ? newwo r d E 50 3 5 

wp = word? 

wh i 1 e ( *wp ! = 7 \0 7 ) 
i 

if ( *wp 7 a 7 I ! *wp 7 e 7 ! ! *wp «=«= 7 i 7 II *wp «=«= 7 o 

; j *vgp s=sr ? Ll 7 I { *Wp = - 7 y 7 ) 

return? 

++wp 5 

j* 

np = new word; 
wp = word 5 

while ( *wp ! = 7 \0 7 ) 

f 

u 

*np+*+* = *wp ++5 
*np++ « 7 7 ; 



*np = 7 \0 7 ; 

mystrcpy ( word «. newwo rd ) 5 



/* end "abbrchk" */ 



alphanumer ic( testchar ) 
char testchar ; 



i i 

i i 

7 Z 7 ) 

7 9 7 ) ) 



el se 

O return < FALSE ) s 




if ((testchar >= 7 a : 
( testchar 1: 
( testchar i 
return (TRUE) ; 



Z testchar <> 7 ; 
7 A 7 ZZ testchar 
7 0 7 ZZ testchar 







binary (word s tab s n> /* binary search */ 

char *word ? *tab C 3 ; 
int nS 

/* find word in tab COD . - . tab Cn-1 3 ? return index */ 



,r 

static int low? high? mid? cond? 

1 ci w = 0 5 
high = n -* 1; 

while ( 1 o w < = high) 

r 

"l 

mid = ( 1 o w + high) / 2 5 

if ( (cond = mystrcmp ( word ? tabCmid ] ) ) < O) 

high = mid - 1? 
else if (cond > 0) 
low = mid + 1 ; 
else 

return ( mid ) 5 



return (-1)5 



/* end "binary" */ 



e x p 1 o d e ( s p t ) 
char s-s* *t ; 



/* expand number in t char ac ter w i se to s */ 






\ o : 



while ( *t ! = ? \0 ? ) 

r 

\ 

if <*t =~ 9 * 9 ) 

mystrcat(s? ” dollar sign ”); 
else if ( *t == ' . • ) 

mystrcat ( s j " point ”); 
else if ( **t == ? j ? ) 

mystrcat (s? " comma M ) 5 

else 

my s t r c a t ( s ? d i g i t s E * t - * 0 ? 3 ) 5 

++t 5 



/* end "explode" */ 



getnum ( ) 



static int num; 



while ( ( (nuni = gkey(>> < 9 0 9 ! ! num > ? 9 ? ) ZZ num ! = ESCKEY) 

say ( "press a digit or press escape”); 

J 

ERJC (num « ESCKEY) 

return (ESCKEY) 5 



return ( num 



? 0 ? ) ; 



l 

l 



char getscr ( ) 



char a; 

a = get sc ( co lumn+256*l ine ) $ 
return ( a ) ; 



itoafnj s) /* convert n to characters in s */ 
char s [ II 5 
i n t n ; 



static int itn?iti; 

i t n = n ? 
if ( i t n < 
i tn = 
i t i = 0 5 



do 

r 


/* generate 


digits 


in reverse order 


*/ 




sCiti-H+U = itn 


% 10 + 


? 0 ? ? /*get next 


digit*/ 


*>. 


while ((itn / = 


10) > C 


))? /*delete it*/ 




if 


( n < 0 ) 









sCi ti++3 = 



o ) 

-itn? /* make n positive */ 



sEitill = ? \0 ? 5 
reverse ( s ) 5 




movecur sor ( ) 

/* move audio cursor to same point as video cursor */ 



stat ic int j 5 

j =* gccp < ) ; 
column = j % 256? 
line- j / 256 ; 

if (column < Icol !! column > rcol !! line < top) 

f 

L 

column - Icol 3 
line = top; 

say ("video cursor out of current bounds"); 
say ( "moving audio cursor to top left")? 



O ***•****•*************•***********■*********/ 
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t a t i c i n t z ", 




z - myreadO; 
if ( z « 26 ) 

2 - EOF:; 
return ( z ) ; 



s 



>:• ■¥• * # * # *r -V- * *• ¥: * ¥: ¥. : 



mystrcatts? t) /* concatenate t to end of s */ 
char *s ? *t; 

r 

\. 

while (*s++> /* find end of s */ 



— s 5 

while < *s++ “ *t++> /* put t on end of 5 */ 



/ •#«*••# •¥*# •£<£•& #■ #■# «#• 



mystrcmp < s «* t) /* return <0 if s < t ? 0 if s ~ t ? >0 if s > t */ 
char *£? *t ? 



r 

for ( ; *5 ssss *t 5 s++? t++) 

if <* 5 sss *\0 9 ) 

return ( 0 ) ? 



return < *s - *t )|5 

•> 



mystrlen(s) /* return length of string s */ 

char *s; 



static char *strp; 



s t r p = s 5 
while <*5trp) 
s trp ++ l 

returntstrp - s); 



•**•*•*■*/ 



reverse ( s ) /* reverse string s in place */ 

char sC 3 ; 



char rc; 

s t a t i c i n t r i ? r j ; 



f o r (ri = 0 ? r j - my s t r 1 en ( s ) 

r 

O rc = sCri ]; 

ERJC s[ r 1 ! = s L r j 1 j 

hriTiUTTir.Tra^ T y- ; ] — — ■ 



1 5 ri < r j ; ri++? r j — ) 



5 



say ( phr ) 
char phr HU 5 

/#■ Bays the phrase pointed to by phr. */ 



static int ich; 

static char *php? 

static char savech rr ? \0 ? 5 

if (phr C03 ===== ? 7 && phr Cl 3 “ ? \0' && savech == 7 7 ) 

return ; 

if (#phr == *\Q*) 
retur n ; 
php = phr 5 

wh i 1 e < *p h p ! = 7 \0 7 ) 

r ' 

■'y 

ich = *php++; 
ich = TOLOWER( ich) 5 
if (pausetog && ich == ’ ’ ) 

send < pausestr ) ; 
putcm( ich ? ncomm ) ; 

•v, 

J 



savech = ich; 
putcm ( EOF’ ? ncomm ) 5 



/* end "say" */ 



kbac k < ) /* save characters that may be backspaced over to say them later */ 

r 

L 

static int p ? j ? c 5 

p = g c c p ( ) 5 
c = p % as 6; 



if <c ! = 0 ) 

j = get sc ( p - 1)5 
del chi = j *A 256 5 



c = c - 1 ? 
if ( c ! = 0 ) 

jr 

j = getsc ( p - H ) j 
delchS = j V„ 256; 

■v 

j 

bscount - 05 /* no output since 
/* end " kback" */ 



«■**********■**■>!•****•*■*«■*****/ 



@02223133 



backspace 



pressed */ 
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char phrED? 



/* Bend out unchanged the string pointed to by phr - */ 



static int kk? 
static char cc? *phpl? 

phpl = phr? 

while (*phpl ! = ’’ \ 0 ) 

r 

\ 

cc = *phpl++5 
k k = cc; 

p u t c rn ( k k ? nc o mm ) ? 



putcm ( EOP 9 ncomm ) ? 

/* end "send" */ 



char src(c) 



char c ? 



char *numberchk ( ) ? 
static char str ing C50D ? 

if (c == oldc) /*one more of the same*/ 



V 

if ( ALPHABETIC ( c ) !! NUMERIC <c ) ) 

return ( c ) ? 

++srcc t ; 
return ( •” \Q 9 ) ? 



/* at this point we have a new character */ 

/* now w e test to see if the previous characters were repeated */ 



if (erect ! = 0) 

/* deal with repeated characters */ 

/* if old character was pronounced say count? otherwise say nothing */ 
if <*asciiCol dcD != *\Q* 

&Z. ( *asc i i Co ldc 1 ■ ! = ^ S » * ( asc i i Co 1 dc 3 + 1) != *\0*) m 

) 

i 

■Ksrcct- ; /■* adjust count to include first character */ 
i toa ( sr cc t ? string ) 5 
say (numberchk ( string ) ) ? 
say ( "times" ) ? 

J' 

sr cc t = 0? 



oldc = c ? 
return(c ) ? 

/* end "sre" */ 



S3 

nRic 



char word C 3 ? 



i n t n ; 

n = b i nar y ( wor d ? c tab ? 1 1 ab ) ; 
if ( n ! = - 1 ) 

mystrcpy ( word «. u tab C n 3 ) 5 
> /*end "userchk" */ 
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end ram 



; 1 ast ed i ted by p „ m . 

; 4 : 1 3 p . m « ? Apr. 36 ? 1 9S5 

> This is file "xbef .asm" 

;We have split the assembly code into two files so that " 
Swill be put as the last uninitialised ram space, 

5 

codeseg segment para public * code" 
assume cs s codeseg 
ex tr n my i n i t : near 

5 initialize 
$hegin proc near 
jmp my in it 
$ beg in endp 

codeseg ends 
end 





1S7 



I 

1 

I 

1 



5 last edited by p.m. 

•J A s 1 3 p • m » ? Apr . 2i£> ? 1903 

sThis is file " x aft. asm" 

5 

SThis file must be linked at the very end so that endram will 
5 be at the top of unitialized ram 

codeseg segment para public 9 c ode 81 
assume cs : codeseg 
ex trn v i ma_ s near 
e x t r n end r a m s n e a r 



a 

a 

i 

i 

a 

i 

i 

l 

a 

a 

a 

a 

a 



; •************#■ *#**■**#**■ ■##****#■**«•*■* 

? Come here on a display interrupt. First do the display 
5 and then call vima with ax ■= £. This will cause vima 
f» to call myscreen( > . 

mylO proc near ^display interrupt 
jmp mylO.j 
saveax dw ? 
savEax dw ? 
savesp dw ? 
savess dw ? 
fill er dw 90 dup ( ? ) 
mystack dw ? 
my 10 j s 

mov cs : saveax •» ax 

call intlO 5 do display 

mov cs:sav£ax?ax 

mov css savess ? ss 

mov cs : savesp ? sp * 

c 1 i 

mov ax P cs 
mov ss ? ax 

mov ax? offset mystack 
mov sp?ax 
st i 

mov ax>csssav2ax 

pushf 

push ax 

mov ax s cs: saveax 

cmp ah , 9 ; write attribute/character at current cursor position 
jb mylOr 

cmp ah? 10 ?write character only at current cursor position 

j a mylOr 

push bx 

push cx 

push dx 

push ds 

push es 

push si 

push di 

push bp 

mov ah ? 0 

push ax 

mov axj.cs 




mov ds?ax 
mov es?ax 
mov ax?E 




ush ax 
ail vima 
op ax 




pop bp 
pop d i 
pop si 
pop es 
pop ds 
p ci p d x 
pop C>! 
pop bx 

my 1 Or : 
pop a x 
popf 
cl i 

mov ss ? cs : savess 
mov sp $ cs s savesp 
sti 
i ret 

my 10 endp 



***********:***************##******#*****#****#****#****#■*#• 

We save original BIOS display interrupt address here 

intlO proc near 5 display interrupt 
pushf 

db 09 ah 5 inter-segment direct call 
ilOoff dw 0 
ilOseg dw 0 
ret 

intlO endp 

; *^^*^**#***^********** ^ ^*^ ******^*******^ #***4f********-^**** 
5 

; We come here on key interrupt* call vima with ax = 1 
; which results in a call to my key ( ) ? and then come 
l back and get the key and return it to the calling program 

my 16 proc near *key interrupt 
pushf 
cmp ah*0 
j e v i 1 6 
popf 

db Oeah ; inter -segment direct jump 
myl6off dw 0 
myl6seq dw 0 
5 

v i 1 6 : 

mov cs : save ax * ax 
mov cs : savess ? ss 
mov cs: savesp * sp 
cli 

mov axycs 
mov s s 3 a x 

mov ax* offset mystack 
mov sp*ax 
sti 

mov ax jcs : saveax 
push ax 
push bx 
push cx 
push dx 
push bp 
O lUsh si 

ERIC ish di 

«aasi JU5 f- 1 h b 
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I 



push ax 
mov ax s cs 

mov dsr.a>: 









mov es ?ax 
mov ax ? 1 
push a>: 

call vima_ Son return ax will have result of intl 6 

add sp ? 4 

pop es 

pop d s 

pop di 

pop si 

pop bp 

pop dx 

pop cx 

p O P h X 

pop ax 
cl i 

mov ss 3 cs : s a v ess 
mov sp 3 cs : savesp 
st i 

popf s on old stack 
db Oeah ; inter-segment direct jump 
myl 6 c«f dw 0 
myl 6 se dw 0 

3 

my 16 endp 

3 

3 

5 We save the or iginal 'BIOS key interrupt 
? vector here. 



intl 6 proc near 5 key interrupt 
pushf 

db 0 ?ah 3 inter -segment direct call 
il 6 off dw 0 
i! 6 seg dw 0 
ret 

inti 6 endp 



3 This routine is called with a character 
; and a Comm port number. It sends this character 
; out the specified Comm port. It is used to 
; send data to the synthesizer 

3 

public putcm_ 
putcm_ proc near 
mov ax 3 0 
call $sav 

mov ax b word ptr 8 EbpD 
p tcm_: 

mov ah 3 1 

mov dxjword ptr lOEbpD 

int 14h 

ret 

putcm_ endp 



l 



5 *¥r***r?r*r*r#r*** V. ************** ******* 



? 

O This nets the current video cursor position 

I ERIC and returns it to the calling program. 
jpinzxza Q e& ibm Bios description for Int 10 for deta 



i Is 
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1 

I 

I 

1 

I 



public gccp_ 
qccp_ proc near 
? get current cursor position 
mo v axjO 
call $sav 

5 get current cursor position into ax 
m o v ah j d 
mov bhjO 
push bp 
call inti 0 
mov axjdx 
pop bp 
ret 

gccp_ endp 



? This routine gets a character from 
5 a screen location specified by the parameters 
5 sent by the calling program 

i See IBM BIOS description for Int 10 for details- 



f 

1 



public get sc__ 
get sc_ proc near 
mov axjO 
call $sav 

?read current cursor position 
mov ah? 3 



I 

ft 

I 

l 

ft 

ft 

ft 

I 

ft 



mov bhpO 
push bp 
call, i n 1 1 0 
p o p b p 

push dx ? save result 
5 set cursor to desired read position 
mov dxjword ptr 8 [bp 3 
mov ah j 3 
mov bhsO 
push bp 
call int 10 

pop bp ;dx is still on stack 
rread attribute/char at new cursor position 
mov ah ? 8 
mov bhsO 
push bp 
call int 1.0 
pop bp 

pop dx ;get old cursor location 
push ax ; save attribute/char 

5 restore cursor position 
mov ah? 3 
mov b h ? 0 
push bp 
call int 10 
pop bp 

pop ax ;get back attribute/char 
ret 

getsc_ endp 



ft 



.g. 

This routine looks for a key. If found 
buffer and returns ascii value of key. 

O it returns S55 



ERIC 



gflltiTiUTTir.TilLtd rj > (hi j « 



i t leaves 
If no key 




key in 
f ouncl 



mov ah ? 1 
call i nt 16 

jz short zky ;if zero? no code available 
mov ah ? 0 

ret 5 ax has code 
zky: 

rnov ax ? 255 
ret 

zkey_ endp 



$ ******************** *&*##&*■•¥:*#* 

? 

n This routine waits until there is a key in the buffer 
? and then removes the key and returns with it. 



pub lie g key_ 
g key_ proc near 
mo v ah ? 0 
call i n 1 1 6 
rnov ah ? 0 
ret 



gkey_ endp 




5 Routine syopen_ opens a file called synth . 
$ Routine syr ead_ reads a character from it. 



? 

pub lie syopen 



public syread 



syopen^ 


p r ci c 


m 


a 

e 

-r-f 


? 

sydta 


db 






syf cb 


db 




db 




db 


syb 1 ock 


d w 


sysi ze 


dw 




db 


syrec 


db 




db 


sy j mp : 


pUSh 




rnov 




rnov 




mo v 




rnov 




i nt 




mov 




mo v 




i nt 




mov 




mov 




mov 




P". r. pi 




mov 




ret 



near 

short syjmp 



0 

“SYNTH 

O 

0 

16 dup ( ? ) 

O 

4 dup (?) 
ds 

b X ? C S 
d S ? b X 

dx ? offset sydta 

ah ? 1 ah 

Elh 

dx «. offset syf cb 

ah ? Of h 

Elh 

syb 1 ock ? 0 
sysi ze ? 1 
syrec ? 0 
ds 

ah ? 0 



;set disk transfer addre 



? open 



? set up starting point 
; one-byte records 



\ syread _ : 

push 

rnov 

:RJC rnov 



ds 

b X ? C S 
d S «. b X 

d x ;i off se t sy f c b 
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int 

fTlD V 

mo v 
pop 
ret 



Si h 

a!? byte ptr 
ah ? 0 
ds 



sydt a 



syopen_ endp 






Routine myopen_ opens a file called table. 
Routine myread_ reads a character from it. 



pub lie: 


my open 




public 


myread 





my open _ 


pr oc 


near 




j mp 


short myjmi 


mydta 


db 


0 


myf cb 


db 


0 




db 


? TABLE 




db 




myb 1 oc k 


dw 


0 


my s ice 


dw 


o 




db 


1 6 dup ( ? ) 


rnyrec 


db 


0 




db 


A dup ( ? ) 


my jmp : 


push 


ds 




mov 


b x ? c s 




mov 


d s ? b x 




mov 


dx? offset i 




mov 


ah ? 1 ah 




int 


Elh 




mov 


dx * offset i 




mov 


ah ? Of h 




i nt 


Elh 




mov 


myb 1 ock * 0 




mov 


my si ze ? 1 




mov 


myrec ? 0 




pop 


ds 




mov 


ah ? 0 




ret 




myread_ : 


push 


ds 




mov 


b x ? c s 




mov 


d s ? b X 




mov 


dx ? offset 




mov 


ah ? 1 Ah 




int 


Elh 




mov 


al ? by te p t 




mov 


ah ? 0 




pop 


ds 




ret 




5 

myopen_ 


endp 





set disk transfer address 



5 open 

5 set 
? one 



up starting point 
-byte records 



myd ta 



ERIC 



0_'hese routines are used by the c compiler for entry 
xit from called subroutines 
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to and 






public $ret 
$sav proc near 

p o p b X 

push di 
push si 
push bp 
mov bp ? sp 
add sp?ax 
c a 1 1 b x 



rnov 


sp 3 bp 


pop 


bp 


pop 


si 


pop 


d i 


test 


a x 3 a 


ret 

av 


en dp 



- **************** ***************** *****■*•**• 

? 

s This routine is used to compile the switch statement 

3 

public $swt 
$swt proc near 
pop bx 

rnov c>j?word ptr cs:Cbx3 
add bx?E 
jcxz eswt 
SWt 1 oop s 

cmp ax 5 word ptr cssCbxl 
je found 



add 


b x P 4 




lo Op 


swt loop 




eswt s 


jmp 


word ptr 


cs: CbxD 


f ound s 


jmp 


word ptr 


cssECbx] 


$5Wt 


endp 





5 ***** ************ ******* ***** ******** 

5 

5 This routine is jumped to by the first statement 
; save the BIOS vectors? substitute our vectors 
? and then leaves and stay resident . 

public my in it 

my ini t proc near 

;get int lOh and int 16h vectors 
5 

rnov ah?35h ?get vector for 

rnov alplOh j interrupt number lOh 

int Elh 

Snow es:b>: has vector for int lOh 
; save in our int lOh call area 



rnov i 1 Goff ? b x 
rnov i 1 Oseg ? es 

Snow put vector to my 10 in BIOS int lOh area 



5 put 
rnov 



ERJC 



«V 
IV 
aiC3_t V 



address of my 10 

axjcs 

ds ? ax 

d x ? o f f se t my 1 0 
ah 3 25h ; put vec: 



in 



or 



d s : d x 



for 



in xbef.asm 



2.04 



int 21h 






mov ah ? 35h 5 get vector for 

mov al ? 16h 5 interrupt number 16h 

int 21 h 



? now esshx has vector for int 16h 
?save in our int 16h call area 



mov i 16of f n bx 
mov il6segj.es 
mov myl6off ?bx 
mov my 16seg ? es 
mov my 16 of ? b x 
mov my 16se ? es 



; now put vector to my 16 in BIOS int 16 area 



5 pUt 
mov 
mov 
mov 
mov 
mov 
i nt 



address of my 16 in dssdx 
ax ? cs 
ds 

dx ? offset my 1 6 



ah 
a 1 
Sih 



25h ?put vector for 
16h ; interrupt number 



16h 



; initialize vima 



mov axjcs 
mov dsjax 
mov ax jO 
push ax 
push ax 
call vima 
pop ax 
pop ax 



5 now quit 
? 

mov dx? offset endram 
int E7h 

! 

my i nit endp 

*s 

codeseg ends 
end 




1 

I 





SOURCE CODE FOR TALKHELPER FOR THE IBM PERSONAL COMPUTER 





/*this is file speech. c*/ 
/*last edited by p,fii^/ 
✓*?:3B a. m., May 27, 1985*/ 



/* defines for speech program */ 
#inc lude " sdefs" 



/* picture definitions for graphics screen paramenters */ 
#inc lude "pdefs" 

/* standard i/o and file definitions supplied by Aztec C */ 
# i nc lude? " s t d i o » h " 

# i nc lude " fen 1 1 ■ h n 

ttdefine TRUE 1 
#define FALSE 0 



/* +-MH- + 4* 



~h + + -h 



/* Machine specific routines coded in assembler by p.m.*/ 

/* check for a key? return 255 if no key, ascii key value if */ 
/* there is a key? leave the key in keybuffer */ 
int zkey ( ) ; 

/* get a key from keyboard waiting as long as necessary */ 

/* return with ascii code */ 
int gkey( ) ; 



/* send a character out serial port (C0M1 on IBM) to synthesizer */ 
int putcm( ) s 



/* put screen in text mode */ 
int t e x t o n ( ) 5 



/* put screen in graphics mode *•/ 
int graphon ( ) ; 



/* move block to graphics screen memory — an Aztec C library routine */ 
i nt graphmv ( ) ; 



/* working variables */ 



*/ 



/•* black and white data to allow quick changes by block moves to */ 
/•* graphics screen — will be initialized in program */ 

/* ??? used for building scanning inner frames on picture menu ■*/ 



char b 1 ac k C 40 2 , wh i te C 40 1 ; 



/* SCREEN STATUS VARIABLES */ 



int keyson = FALSE 5 /* is scanning keylist on bottom of screen ■*/ 
int line; /*line where next writing goes on screen*/ 

int col 5 /^column where next writing goes on screen*/ 

O 

ERJC 

VAR I ABL.ES RELATED TO CURRENT MENU */ 



int menu? 



/" * n u m b e r o f c u r r e n t m e n u * / 
i n t n e n t r v ? / * n u m ber o f c u r r e n t e n t r y i n curre n t m e n u * / 
char edmocle ? / * :t E ' 1 for special editing? ’R ? for regular mode */ 

/* VARIABLES AFFECTING ALL MENUS */ 

char mmark CMAXMENUB3 ? /* used to mark active menus for garbage collection */ 

/* The following information will be read in from the menu file? but may be */ 
/* altered by the user. Changes may optionally be written out */ 

/* global information about menus */ 

/* number of menus — may not exceed MAX MENUS */ 
int menuct; /^number of menus*/ 

/* scan rate — a number between 1 and 30 */ 
int grate? 

/* input mode: 

K — K e y s e 1 e c t i o n 

A — All keys as a single switch 

S — Single switch attached to joystick button connector 
D — Divided keyboard as two switches 
T — Two switches attached to joystick connector 

*/ 

char g input ? 

/* type of menus: == picture? ? T ? == text */ 

char gtype? 

/* arrays of menu-specific information */ 

char *mnameCMAXMENUS!3 ? /*names of menus*/ 

/* Number of entries in each menu */ 

/* For text menu may not exceed MAXENTRIES- */ 

/* For picture menu must be 4-? 9? 16? or E5 */ 
int msiceCMAXMENUSH ? 

char *mlabel C MAX MENUS 3 C MAX ENTRIES 3 ? /*entry labels */ 

char *mtext CMAXMENUS3 CMAXENTRIES3 ? /*entry phrase or action */ 

/* VARIABLES FOR STRING MANAGEMENT */ 

char sbuffCWIDTH + EH? /^buffer for string input*/ 

chai csCMAXBUFHyi /*buffe£ fol strings selecteZ by user*/ 

int eendCSOH; /* locations of ends of phrases in "to say" buffer */ 

O 

ERIC end if! /* index for send ? e.g. eend [ eend i 3 */ 






char buf CPSIZE3 ; /^buffer for reading in a picture*/ 



/* STRING CONSTANTS */ 

/* end of string — used for setting pointers */ 
char eos ~ 7 \ 0 7 ? 

/* deignators for left and right columns */ 
char lrdesCD = LRDES ? 



/* special function keys */ 

char specialC] = C LJNDKEY , D I SKEY , EX ITKEY ? SAYKEY ? EEKEY ? EMKEY ? EDKEY * REGKEY ? 7 \0 7 3- 

/* keyset to display at bottom of screen for handicapped people */ 
char keys 1 C I = "? < * & 0 1 E 3 4 5 6 7 8 9 " 5 

char keys ELI = ”E T Q A IHNSRLUDYWBMCBF K P V J X 2 " 5 
/*******************************/ 
ma in ( ) 

/*read in menus 9 then go into loop getting and obeying user commands*/ 

r 

1. 

static int choice? 
unsigned int i?j?k? 

/* lazy way to initialize to values for IBM graphics adapter */ 
f or ( i «05 i < 40? i++) -C 

blackC i] = 7 \000 7 5 
white:!] = 7 \377 7 5 

y 

/* initial modes */ 
edmode = 7 R 7 ? 

texton( > 5 /* probably not needed */ 
re ad menus ( ) ? 

showmenu ( "MAIN” ) ? /*put main menu on screen*/ 



/* initizialize "to say" buffer */ 
c s [ 0 ] = 7 \ 0 7 ? 

eend i = 0 5 
eendEeendi++] = OS 

/* where we start writing on screen */ 
line = BOTTOM - 4? 
col ss l ; 

1 

/* MAIN PROGRAM LOOP */ 



while (TRUE) £ 



/* make a valid 
/* get i n < ) will 
/* get in( ) will 
/ * g e t i n ( ) will 



choice — ignore illegal choices */ 
return a large number for illegal entries */ 
return a negative number for command keys */ 
return a positive number for entry selection */ 



while( (choice = getin<>> >= msize:menu]> 
? 



/* 
/* 
/* 
O /* 

ERLC /* 

hfliiiTikTrihTigaa 



deal with special handicapped input mode for command 
non-typing user can select command keys off menu */ 
(If first character in the phrase is “k' 1 ? this means 
next character signifies a command character chosen 
the user „ ) */ _ 

209 



keys */ 

the */ 
by * / 



if ( mtext Cmenul [choice] L i 3 == *<*) choice = -SAYKEY; 
else if (mtextCmenu] [choice] C 1 U == ? ’ ) choice = -DISKEY? 
else if < mte?xt [menu] Echo ice! C 1 3 == ? ? ) choice = -UNDKEY ? 
else choice = - mtext CmenuU Cchoicell C 13 5 



/■stake appropriate action based on choices/ 
switch (choice) C 

case -EXITKEY: /sexit to computer operating systems/ 

tex ton ( ) ; 

EDU ( ) ; 
ex i t ( 0 ) ; 

case -DISKEYs /sclear bottom of screen & "to say" in text modes/ 
c 1 r b o t ( ) ; 
c SHOD = ? \ 0 ? ; 
eendi ~ 0; 
eend C eend i ++ U = 0 5 
line = BOTTOM - 4; 
col = 1 5 
CUP< line s col ) ; 
break 5 

case -SAYKEY : /*say string created in text modes/ 

say (cs) ? 
break ; 

case -UNDKEY : /sera se most recent phrase selected in text modes/ 

— eend i ; 

— eend i ; 

cs [ eend C eend i ] 3 = ? \ 0 ? ; 

rep lot ( ) ; 
break ; 



case -EDKEY s /s enter helper edit mode with keyboard entry & text 
edmode = ? E ! ‘ 5 
showmenu ( mname C menu 3 ) ? 
clrbot ( ) 5 
b r e a k ; 

case -REGKEY : /s exit helper edit mode — go back to mode for thi 
edmode = ? R ? ; 
showmenu ( mname £ menu 3 ) ; 
if ( gtype == ? T !i ) 
c lrbot ( ) ? 
break ; 



case -EliKEYs /* all options except changing label or phrase */ 
ed i tmenu ( ) ; 
clrbot ( ) 5 
rep lot < ) ; 

break ; , 

case -EEKEYs 
emenuf > ? 
clrbot ( ) ? 

. rep lot ( ) ; 
break; 




default: /smake a selection from menus/ 

nentry = choice; 

/s new menu selected s/ 
i f < s m t e x t £ m e n u .1 £ n e n t r y 1 - = 11 s ? ) C 
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s creens/ 



s menu */ 



if ( g t y p s == - T ? ) C 
line - BOTTOM - 3; 
col = 15 

show text ( cs 9 BOTTOM , WIDTH ) 5 



/^selection made from within a picture menu*/ 

/*say it at once*/ 
else if (gtype =- ? P " > C 
say ( mtex t E menu 3 H nent ry 3 ) 5 

if (edmode = = ? R ? ) *C /*wa i t for speech then flip box back*/ 
j ; = str len<mtext [menu] Enentry] ) *MSPEED*£00 5 
for <i =05 i < j 5 i++)k = j/ 7; 
f 1 i p < ms i. z e C menu 1 * nen t r y , b 1 ac k ) 5 



/^selection made from within a text menu*/ 

/*put it on the screen to build a phrase to say later*/ 
else C 

if (col ! = 0) C 

str cat ( cs ? mtex t [ menu 3 Enentry] ) ? 
strcattcs," “ ) 5 
eendCeendi++D = strlen<cs)§ 

show text < mtext E menu I! C nen try] ? BOTTOM * WIDTH ) ; 
showtext ( " ** j BOTTOM 9 WIDTH) ; 



break 5 

j 

j 

•v 



/*************************.** **********/ 



replot<) /#clear bottom of screen and show text in cs*/ 

r 

c 1 rbot ( ) 5 
I i ne = ; 

c o 1 = 1 ; 

CUP (BOTTOM - 4,1)5 
showtex t ( cs , BOTTOM , WIDTH ) 5 



•* ************ 



showtex t < s , b , w ) 

/* shows text in a window down through line b ? of width w */ 
/* on entry line has number of next line to write on */ 

/* characters that do not fit in the window are not shown */ 
/* returns index in s of last character shown */ 



int b* /*bottom line of window*/ 
int w5 /* width of window */ 
char s C ] 5 /*str i ng to be shown */ 



char *sl 5 /* points to end of string */ 

char *sb ; /* for where unwritten part of string starts in s */ 
char *si ; /* working string pointer */ 



= S 5 

ERIC = sb 



9 



+ str 1 en ( s ) 5 



/* 


s k ip i n i t i 


a 1 blank 


in column 1 


*/ 




if 


(col === 1 


&:& *Sb - = 


? ? ) -f + sb 5 






/* 

if 


if string 
(si - sb < 


will all 
w - col) 


fit on this 

r 

X 


1 ine just 


print it */ 



CUP ( 1 ine,col ) ; 
printf ( "*/.s" ,sb) 5 
col = col + si - sb j 
sb = si + 1 ; 

J 

else C /* won’t fit */ 



/* try to break string at a blank; if impossible print w characters */ 
for (si -sb+w-col - 1; si ! = sb 5 — si) C 



if 

“k 

J 


( *S i =as ? 


r ) break 


if 


( * S 1 as =s ? 


{ 



*si = ’XO’; 

CUP ( linspCol ) ? 
printf ( "tts 11 5 sb ) 5 
*si = ? ; 

sb = s i + 1 5 

} /* end if (*si === * ? ) */ 



++ 1 i. ne ; 

COl « 1 5 

3- /* end else */ 
y / * end while */ 

]• /* end showtext */ 



say(s) /*say the string pointed to by s */ 
char *s ; 

*C 

int k; 

putcm ( 32 ? 0 ) ? 
while < *s ! as \0 ? ) { 

k = ^s++ ; 
putcm < k * 0 ) 5 

s 

putcm ( 32 ? 0 > ; 
p u t c m ( 1 3 * 0 ) ; 



getin() /*get an input command*/ 
C 

int k j» m ; 



m = g input; 

if (edmode •’’E 7 ) m = ? E ? ; 
switch Cm) *C 

case ? K : ' : /*Key selection*/ 

case ? E ’ : 

return ( key in ( ) ) ; 

case p A ? s /*A11 keys as a single switch*/ 
if (gtype ? P ? ) k = pscan < ? A ’ ) ; 
e 1 se k = t sc an < ’ A ? ) ? 




212 



case 7 S 7 :: /^Single switch (joystick button on Apple/IBM}*/ 

i f ( g type 7 F' 7 ) k = pecan ( 7 S 7 ) ? 
else k = t scan ( 7 S 7 ) 5 
break 5 

case 7 D 7 s /*Double switch - — keyboard space bar vs all others*/ 
if (gtype === 7 P ? i k = pstep ( 7 D 7 ) 5 
else k = t step( 7 D 7 ) 5 
break 5 

case 7 T 7 : /^-Joystick socket double switch*/ 

if (gtype == 7 P 7 ) k = pstep ( 7 T 7 ); 
else k = tstep ( 7 T 7 ) 5 
break 5 

•v 

j 

return ( k ) 5 



j 



keyin< ) /*get a key selection from keyboard*/ 

r 

i n t k 5 



k ~ toupper ( gkey ( ) ) 5 

if (mindex (special yk) ! = -1) return(-k) ; 
return < m index ( Irdes * k ) ) 5 



/ ****' 



button( ) /* get joystick button as a switch */ 

/* if first button is closed returns 0; if second button is closed returns :L*/ 
/* if both or no buttons are closed returns £55 */ 

r 

char c 5 



outportb (OxEOl *0xff ) 5 
c = i np o r t b < 0 x £0 1 ) ; 
c = c £•: 0x30; 
if (c === ::: 0x10) return(0) 5 
if < c 0 x 20 ) ret ur n (1)5 
return ( £55 ) 5 






debounce( ) /* make sure button has been up (switch open) a good while */ 

r 

int i ; 

i = 0; 
d d C 

if (buttonO == 255) i++5 
else i == Oj 
3- wh i 1 e ( i < 200 ) ; 



pscan(d) /*scan with a picture menu*/ 
char d; /•*•■' A* — all keys as one switch, 

r 

int b 5 



ERJC 



?ntry -- 



— single switch*/ 
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f' 1 ip ( msi zeCmenu 11 ? nentry >» wh i te ) 5 



if (nentry < 5 ) 

h = pause ( grate 5 15 d ) 5 
else 

b = pause ( grate ? 10 ? d ) 5 
flip ( ms i z e fl menu II ? nentry ? b 1 ac k ) ; 
if (Ci ™ *S* ) 



debounce < ) ; 

if ( zkey < ) != 255 && gkey(> == EDKEY ) return ( -EDKEY ) 

if (b == 0) break; 

j' 

else /* d ~= ■"A’ */ 

jT 

V. 

if < 2 key ( ) != 255) 

r 

K. 

if ( gkey ( ) == EDKEY) return ( -EDKEY > ; 
break 5 



++nentry ; 

if (nentry == msizeC menu 3 ) nentry = 0; 

T 

J" 

return ( nentry ) ; 

j - 

/**•#***•***.* 



int b j col 9 line; 
nentry = -1 ; 

if (d == "S’) debounce ( ) ; 

/* put cursor on screen */ 

while (TRUE) C 

if (nentry == —2) C 
col = WIDTH/ 2 ; 

1 i ne = 1 ; 

•j 

j 

else if (nentry < ( msi zeCmenu D h -1 ) /2 ) C 
col = 1 ; 

line = nentry + 2; 

j 

else C 

col = WIDTH/E 5 

line ~ nentry - (msi zeCmenuH-l ) /2 + 2; 

J 

CUP < 1 ine jcol ) ; 

O Dr intf <"*"); 



r 

\. 




tscan(d) /* 5 can with a text menu*/ 
char d; 
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to = p ause (grate? 1 5 ? d ) 5 
else 

to = pause < gr a t e j 1 0 jd) j 

CUP< line, col ) ; 
prir>tf<" " > ; 

if (d == ’S’) 

r 

v. 

/'* throw away all keys except EDKEY. Return if EDKEY hit */ 
if ( 2 key ( ) != E55 && gkeyO == EDKEY) 

return < -EDKEY) ; 



if (to =-- 0) 

.r 

K. 

i f < nentry 
break s 
i f ( nentry 
nentry = 
else 

nentry = 
s 

else 



/* the button has been 
>= 0 ) 

-2 5 
5 



if (nentry == -£) 

nentry = (msiseCmenu] - l)/£? 
++nentry 5 

if (nentry == msi set menu D> nentry 



pressed 



1 ? 



*/ 



J- /* end if (d 



) */ 



else /* d == 'A 7 */ 

r 

i. 

if < 2 key<) ! « £55) /* a key has been pressed *•/ 

r 

L 

if <gkey<> == EDKEY) 
return ( -EDKEY ) 5 

if (nentry > = 0) 
break $ 

i f ( ner: t r y == - 1 ) 
nentry = -£? 
else 

nentry = -1; 

•v 

j 

else 

r 

V 

if (nentry == -£) 

nentry = (msizeCmenul - l>/£? 

++nentry ? 

if ( nentry == msi zetmenu] ) nentry = -1 ; 

j - 

> /* end else C d == " A ? 1 */ 

5 /# end while «•/ 
r e t ur n ( nen t r y ) 3 



EKLC 



4C. .g. g. g. 4f- & £• •¥■ 4#- & 4£- 4£- •#* 4£- -jf- ¥r -Jr / 
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char d; /*’D' for keyboard as double switch* ’T' for 2 switches* 

r 

k 

i n t k 5 

nentry = 0; 
wh i 1 e ( TRUE ) C 



f 1 ip ( msi set menu I! •» nentry ? wh i te ) ? 
if (d « ? T ? ) 

jr 

V- 

debouncet ) ; 

while (<k = button* ) ) != 0 k != 1) 

if ( zkey ( ) != 255 &=&= gkeyO == EDKEY ) return* -EDKEY > 5 



if ( 


k =“• 0) 


b r e a k ; 


j 

else 

r 


/ * d — — 


’D’ */ 


\ 

if 


( ( k = g k 


:ey ( ) ) == EDKEY) return * -EDKEY > ; 


i f 


* k ! = ’ 


J ) break; 



j 

flip (msi zeCmenu 3 «. nentry ? b lack > 5 
++nentr y 5 

if (nentry == msi zeCmenu] ) nentry = 05 



return ( nentry ) 5 



tstep(d) /*step with a te>;t menu*/ 

char d; / * ’ D ’ for keyboards ? T ? for switches*/ 

r 

\. 

int col ? line? k 5 
nentry ~ -1 ? 



k = 254- ? 



while (TRUE) C 

if (nentry == -2 ) C 
col = WIDTH/2? 

1 i ne = 1 5 



else if ( nen t r y < 
c o 1 = I? 
line = nentry + 

•> 

j 

e 1 se { 

col = WIDTH/2? 



( msi zeCmenu 3 



+ 



1 )/ 2 > 



line = nentry - (msi zeCmenu 3 + 1 ) /2 + 2; 

•> 

j’ 

CUP ( 1 ine s co 1 > 5 
printf < ) 5 



if (d — ? T ? > 

debounce ( ) 5 



ERJC it ( d == ’ d •’ > 

if < <k = gkeyO) ~ EDKEY) return < -EDKEY > ; 
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if <d == ’ T’ ) while <(k = buttonO) != 0 &.&■. k != 1) 
if <zkey< ) != £55 && gkeyO == EDKEY ) return (-EDKEY) 



if <<d == 11 D ? && k ! = ’ 11 ) ! 

if ( n entry >= 0) 
break ; 

if (nentry == -1) 
nentry = -£; 
else 

nentry = -1; 

J 

el 5e 

r ' 

c 

if (nentry == -2) 

nentry = (msizeCmenu] - l>/£; 
++nentry ? 

if (nentry == ms i ze C menu 3 ) nentry 

\ 

j 

CUP( 1 inejcol ) ; 
printfC " >; 

\ 

J 

CUP ( 1 ine ? col ) ? 
printfC " ); 

if (zkeyO ! = 255 ) k - gkeyO 3 
if ( k ===== EDKEY) return ( -EDKEY) ; 
return ( nentry ) ; 



k ===== 0 ) ) C 



■1 3 



f 1 i p ( s i z 


e h be 


« x jcolor ) 


/*f 1 i ps 


black /white for box on screen 


i nt size 


’ ? box 


! 5 


char *c o lor 5 

r 




i 

stat ic 


int 


>:ACA3 a CPX43-5 


static 


i n t 


y4C43 = CPY4>; 


static 


int 


h4C43 = CPH4 3-; 


static 


int 


v4C4 3 = CPVA >; 


stat ic 


i nt 


X9C93 = C P X 9 ] ; 


static 


int 


y9C9 3 = CPY93-; 


stat i c 


i nt 


h 9 C 9 3 = CPH93 ; 


s ta t i c 


int 


v9C93 = CPV93-5 


stat i c 


int 


>; 1 6 C 16 3 = CPX163-; 


static 


int 


y 16C 163 = CPY163-; 


stat i c 


int 


h 16C 163 = CPH163-; 


static 


int 


V16C163 = CPV163-; 


stat ic 


i nt 


::£5C£53 = -CPXE5A,PXE5B>; 


static 


int 


y£5C£53 = CPYE5A ? PY25B 3- j 


stat i c 


i nt 


h£5C £53 = C PHE5A j PH25B > j 


static 


i n t 


v£5CS53 = CP VESA <■ PVE5B3- ; 


int x ? y 


q h ? V 


5 


int off 


set ? 


star t ? row j 


swi tch 


( siz 


e) t 


case 


4 : 





with size boxes*/ 



x = x 4 C b o x 1 5 
y = y^Cboxl; 
h = h A C h o 1 ; 
v = V'-htbox 3 ; 
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case 9 s 

x = x 9 Cbox 3 s 
y = y? [box 3 5 
h * h 9 [box 3 ; 
v = v 9 Cbox 3 • 
break 5 

case 16 s 

x = x 1 6 C b o x 3 5 
y ” y 1 6 C b o x 3 5 
h = hl 6 Ebox 3 ; 
v = v 1 6 [ box 3 5 
b r e a k ? 

case 25 : 

x = xSSCbox 3 5 
y = y 25 [box 3 ? 
h - hSSCbox 3 ; ' 
v = v 25 Cbox 3 ; 
break ? 

defaults 

err ("bad size")? 
return (-1)5 



for (row = y; row <“ y + 3 ; row++) *C 

if ((row i: 0x0001) == 1) offset = POFFSET; /*o dd row*/ 
else offset = 05 /*even row*/ 
start = offset + 80 *(row>>!) + x? 

/*send line for top of box*/ 
graphmv ( star t ? co 1 or ? h ) 5 



for (row ~ y+ 9 ; row < = y+v- 9 ; row++) C 

if ((row & 0x0001) =~ 1) offset - POFFSET 5 /*odd row*/ 
else offset - 05 /*even row*/ 
start = offset + 80 *(row>>l) + x5 
/*send edges to screen*/ 
graphmv ( star t ? co 1 or ? 1 ) 5 
graphmv ( star t+h-1 ? co lor ? 1 ) 5 



for (row = y+v -3 5 row <= y + v 5 row++) £ 

if ((row & 0 x 0001 ) 1 ) offset = POFFSET 5 /*odd row*/ 

else offset = 05 /*even row*/ 
start = offset + 80 *(row>>!) •+* x? 

/*send line for bottom of box*/ 
graphmv ( star t ? co 1 or ? h ) 5 



kscan(d) /*scan with simulated keyset*/ 
char d; 

r 

■ v. 

i n t bjijjjkli ne ? kco 1 ? k 1 en 1 ? k 1 en2 5 

klenl = str len ( keysl ) 5 
k 1 en2 = s t r 1 en ( k ey s2 ) 5 




i — *~2 5 

0 ,ine = BOTTOM - 1 ? 




CUP<kline,kcol> s 



if ( i < 5 &:Z: kline == BOTTOM 
b = p ause ( gra t e * 1 0 > d ) 5 

else 

b = pause ( grate » 10 ? d ) ; 

if <d == 7 3 7 ) 

debounce ( ) ; 

if \zkev<) ! 

.r 

if (zkeyO 



= £55 ! ! (d == 7 3 
! = £55 £:£: gkeyO 



1 ) 



&:&: b == 0) ) 

= EDKEY) return (-EDKEY) 



if (i >= 0 ) 
break ; 

if ( i == -E) £ 
i = -4; 

'kline = BOTTOM; 

** 

else C 
i = ~2 5 

kline - BOTTOM - is 



else 

■C 

if ( i == -4) £ 
i = -£; 



i += £; 
k c ci 1 + = £ ; 



if < i == klenl kline == BOTTOM -1) { 
kline = BOTTOM; 
k c o 1 = 1 ; 
i = -4 ; 

•> 

j 

else if <i == kler.2 && kline == BOTTOM) £ 
kline == BOTTOM - 1? 
kco 1 = 1 ; 
i = -£; 



*> 

S 

if (kline == BOTTOM) 
j = keysSCil; 
else 

j = keyslCiD; 

if (j == •-<•-) return (13); 
if (j ===== =•?=•> return < 8 ) ? 
return ( j ) ; 
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kstep(d) /*step with simulated keyset*/ 
char d; 

O 

y t i 5 j 5 k j k 1 j. ne » kco 1 ? k 1 en 1 ? k 1 en£ ; 



k 1 en£ 



= str 1 en ( keysS ) ' 

i = -a; 

kline = BOTTOM - 1; 
k col = 1 5 
while (TRUE) C 

CUP ( k 1 i ns , kco 1 ) 5 

if <d == ' D' > 

i f ( ( k = gkeyO) == EDKEY) return ( -EDKEY ) ; 

if (d == -T-) C 
deb ounce ( ) ; 

while (<k = but ton ( ) ) == 855) 

if <zkey<) != 855 && gkey() == EDKEY) return < -EDKEY 

J 

if < (d == ’ D •’ && k != ” ’ ) ! ! ( d —— ' T ’ k == 0>> 



if ( i !?•— 0 ) 
b r e a k ; 

if (i == -8) 

r 

"l 

i = 5 

kline « BOTTOM; 

\ 

j 

else 

#• 

\ 

i = -8 ; 

kline = BOTTOM - l; 



if ( i == -4 ) C 
i. = -s ; 



i +as 2 5 

kcol += 8; 

if (i ■» klenl && kline == BOTTOM -1)C 
kline = BOTTOM; 
kcol = i; 

i as -4; 

■> 

J 

else if (i == klenE kline «« BOTTOM) C 
kline = BOTTOM - 1; 
kcol = l; 
i = -2 5 



if (kline == BOTTOM) 
j = keysEC i 3 ; 
else 

j = keys 1 [ i I! 5 

i f ( j == * < ? ) return (13)5 
if (j == *?*) return ( 3 ) ; 
return ( j ) ; 

O 

ERIC 

.71,1,7.11mm 4,;. .tf. * r .jp. z- .fcZ .ft. 4$. 4?. S- -V- -V- •¥• •£ / 
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get; key < ) 

r 

V 

if (ginput == 7 K 7 !! edmode == 7 E 7 ) return ( gkey (>> ; 

if ( key son « FALSE) < 

CUP ( BOTTOM - 1, 3); 
pr i ntf ( key s i ) ? 

CUP ( BOTTOM ? 3); 
pr intf ( keysE ) ? 
keyson TRUE? 

J' 

if (ginput “ 7 A 7 !! ginput = : = 7 S 7 ) 

return ( kscan ( g i nput ) ) ? 
else return ( kstep ( g input ) ) 5 






getstrin(m) /* returns a string in sbuff — uses current input mode */ 
int m? /■* maximum string to return */ 

r 

int c •» i •» j ? g 1 i ne »gc ol, sc ol, limit; 

pr intf ( ” >”>? 

service (&gl ine,&gcol ) ; 

limit = WIDTH - gcol - l; 



if (limit > m ) 
limit = m ? 



for (j = gcol; j <= gcol + 
pr intf ( " ”); 

CUP ( g 1 ine ? geo 1 + limit); 
pr intf ( "C" ) ? 

if (ginput != 7 K 7 && edmode 
CUP ( BOTTOM - 1,3); 
pr intf ( keysl ) ? 

CUP ( BOTTOM ? 3 ) ? 
pr intf ( keysE ) ; 
keyson == TRUE 5 



limit? j++) ; 



! = 7 E 7 &:£>: keyson «= FALSE) 



CUP ( g 1 ine , geo 1 ) ? 



ngets ( 1 imi t ) ; 



nkey( ) /* returns a key from appropriate input */ 



int Cj si ine? scol ? 



if (ginput ~ 7 K 7 !! edmode == 7 E 7 ) 

return ( gkey ( ) > ? 



scr^loc (&.sl inej&scol ) ? /* save screen cursor position •*/ 



if (ginput «« 7 A 7 '! ginput “ 7 S 7 ) 

c = kscan (g input ) ? 

ERiCse 

^ ,l,l ™ rtn1 111 1 C = kstep ( g i nput ) ; 




CUP ( s 1 i ne ? sc o 1 ) / * r es t o r e screen c ur so r p o s i t i o n * / 
return < c ) 5 



ngets(n) /* gets a string from stdin of maximum n characters */ 
/* string goes into sbuff */ 
i n t n 5 

i n t t ? i. ? 1 » c h 
t = 0 5 

wh i 1 e < < i = nkey < ) ) ! = 13) *C 

if ( i s== 8 ) *C /* backspace */ 
if ( t > 0 ) C 

SCr_iOC (S:l p&:C ) 5 

— c ; 

CUPdsic); 
pr intf' " n ) 5 
CUP' 1 s c ) 5 
— t ; 



else if < t < n ) *C 
pr intf ( "•/♦c" , i > ; 
■ sbuf f C t++3 = i ? 



sbuff Ctl = 9 \0*i 



pause < rat e <■ n ? d ) /* pause specified length of time in 

int rate; /* user specified rate */ 

int n; /* program specified pause constant */ 

char d; /* input mode */ 



uns i g ned int i ? j ? k ? m ; 
i. n t r ? 



scanni ng 



mode *K" / 



r = rate; 
if ' r < 1 ) 
r — 1 ; 
if <r > 30) 
r = 30 j 
r = 31 - r j 



/* liSPEED is chosen for each machine to make pausing machine independent * / 
j = n * MSF'EED * r j 
k = j; 



if (d == "A" > 
for (i = 0; i 

if (d == ’S’ ) 
for < i =03 i 

O turn <255); 

ERIC 



j; i++) if ( ( m = zkey<>> I = £55) return(m) 5 



k5 i+*+) if ( < m = button < ) > != £55) return (m) 5 
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reverse(s) /* reverse string s in place */ 
char s[ 3 5 

r 

v. 

int c ? i ? j 5 

for (i = Oj j = str len< 5 > -1 5 i < j 5 i +••+•? j — ) C 
c « s[ i 3 5 
s[ i 3 = sC j 3 5 
s [ j 3 = c ; 



/ * *#■*•*•* * ■* *■ * * *■*■**■ * * * * * * * * * * * * ******/ 

itoatn? s) /* convert n to characters in s */ 

char b[ 3 ; 
i n t n ? 

,r 

V. 

int i? sign? 

if ((sign = n) < 0) /^record sign*/ 

n = —n; /*make n posit ieve*/ 

i = o; 

do C /^generate digits in reverse order*/ 

sCi++3 = n % 10 + *Q* } /*get next digit*/ 

} while ((n /= 10) > 0)5 /*delete it*/ 

if (sign < 0 ) 
sC i++3 « ? - !i ; 
sC i 3 « 9 \0* 5 
reverse ( s ) 5 

j 



mindex(Ss k) /* return index of t in s * -1 if none */ 
char s[3? 
i n t k 5 

r 

int i ; 



for (i = 0 5 s[i3 != 11 \ 0 ? 5 • i++> 
if ( s f. i 3 k ) ret ur n ( i ) ; 
return ( - 1 ) ; 



/•***■: 



5 -*****/ 



mcheck(s) /recursively check menus for references*/ 
char *s5 /*name of menu to be checked*/ 



int m ? e; /*menu and entry we are now checking*/ 

/*f ind number of this menu*/ 
m = 0 5 

wh i 1 e ( strcmp ( nmameC m3 ? s ) ) £ 
m++ 5 

if (m =” menuct ) err ("menu not on list")? 



\ 

j 



/* if this menu is’ already marked we are done*/ 
O (mmarkCm3 == ? R ? ) return? 

ERIC 

“ffmark this menu*/ 




/ * c h bc k all en t r i 95 * / 

for < e = 0 ; e < ms i ze C menu II ; e++ > 



if (mtext Cm] Ce3 [03 ===== ’-a-’ > mcheck <mte*t Cm] Ce]+i > 5 



/ . 




if 



read menus* ) 



FILE ♦f open ( ) ; 

FILE *menuf i le 5 
char sCMAXSTRING] 5 

menufile = f open< "MENUS” , M r 11 ) ; 

/♦read type of menus ♦ / 
fgets(sj MAXSTR I NG ? menuf i 1 e ) ; 
g type = sC03$ 



/♦read input mode*/ 
f get s ( s ? MAX STRING ? menuf i le ) 5 
g input = sC OH? 

/* read scan rate ♦ / 
f get s < s «. MAXSTR I NG ? menuf i le > 5 

sCstr len < s ) - 13 = 9 \0 9 i /*zap final K \n K */ 
grate = atoi ( 5 ) ? 

/♦read number of menus*/ 
fgets <s s MAXSTRING, menuf i le) ; 

sCstrlen(s) - 1] = 9 \Q 9 i / *zap final '\n'*/ 
menuct = atoi < 5)5 

/ * read i n dividual menus * / 

for (menu = Oj menu < menuct; menu++) C 

/* read size of this menu */ 
f get s < s j MAXSTRING 5 menuf i le ) 5 

sCstr len(s) - 1] = *\Q*i /*zap final 9 \r\ 9 */ 
msizeCmenu] = atoi(s); 

/♦read name of menu*/ 
fgets (Sj MAXSTR ING? menuf i le) 5 
sCstrien(s) - 13 = ’\0’; 
mnameCmenu] = mal loc ( str len( s ) + 1); 

if (mnameCmenu] ===== NULL) err ( "insufficient memory for menus" ) ; 
strcpy ( mname C menu ] ? s ) ; 

for (nentry = 0; nentry < msizeCmenu]; nentry++) { 

/♦read abbreviation - entry pair*/ 
f gets < s 5 MAX STRING ? menuf i le ) 5 
sCstr len (s) - 13 = 9 \0 9 ; 

mlabel C menu] C nentry 3 = mal loc ( str len < s ) + 1); 

if (mlabel Cmenu] Cnentry 3 == NULL) err ( "insufficient memory for menus’*) 
strcpy ( mlabel C menu 3 C nentry ] , s ) 5 
f gets ( s ? MAXSTRING * menuf i le ) 5 
sCstrlen(s) « 1 ] = 9 \Q 9 ; 

mtext Cmenu] Cnentry ] = mal loc < str len< s ) + 1); 

if ( mtext Cmenu 3 Cnentry ] ===== NULL) err ( "insufficient memory for menus") ? 
strcpy ( mtex t C menu] Cnentry] 9 s ) 5 





/ **** * ****** * -X- *r * * * * * * * * * * * * V: * * * * *** / 



showmenu ( menuname ) 
c har ♦menuname ? 

r 

V 

int temp; 
menu = 0 ? 

wh i 1 e ( strcrnp ( mname E menu 3 ? menuname ) ) C 
menu++ ? 

if (menu == menuct) C /* can’t find menu on list ♦■/ 
c 1 r b o t < ) ; 

CUP (BOTTOM - 3, 19); 

pr intf ( "Cannot find a menu named s Ms - " ? menuname ) $ 
pak < ) 5 
rep lo t < ) ? 
return 5 



if (gtype == 7 P 7 &■.&: edmode 7 R 7 ) d isp lay < menu ) ; 
if (g type 7 T 7 !! edmode ==* 7 E 7 ) typeout (menu) ; 



/*************************** *******/ 



typeout (mnp) /*types out menu whose name is mnameEmnp 3*/ 
int mnp; 

,r 

V. 

teuton ( ) ; 

EDU ( ) ; 

/♦write name of menu centered on line 1*/ 

CUP ( 0 5 W I DTH/2 - str 1 en ( mname [ mnp 3 ) /S > 5 
pr i ntf ( " Ms " ? mname E mnp 3 ) ; 

/♦write designators and abbreviations*/ 

for (nentry = Oj nentry < ( msi zeCmenul— 1 ) /2 5 nentry++) 

/* print left column entry *•/ 

CUP (2 + nentry, 3); 

pr intf < "Me . Ms " ? lrdesC nentry 3 ? mlabel [mnp 3 C nentry 3 ) ; 

/* print right column entry ♦ / 

CUP <2 + nentry «■ WIDTH/2+2) S 

pr intf ( "Me - Ms" ? lrdesC (msizeCmenuD + 1 ) /2+nentry3 ? 

m 1 abe 1 [ mnp 3 [nentry + ( msi ze [menu 3 + 1 ) /23 ) 5 

** 

j 

/♦ last li ne */ 

/* print left column entry *■/ 



CUP ( £ + nentry * 3 ) ; 

pr i ntf ( "Me - Ms % 1 r des [nentry 3 , mlabel [mnp 3 [nentry 3 ) ; 



/♦print right column entry */ 



/♦even number of entries 



if ( ( ms i z e [ menu 3 & 1 ) == 0 ) i 
CUP (2 + nentry * WIDTH/2+2); 

PP ® printf < "Me - Ms" ? 1 rdesCmsi zeCmenu3/2+nentry 3 ? 
ly v> mlabel Cmnp 3 E nentry + ms i zeEmenu3 /2 3 ) ; 
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CUP ( BOTTOM 



, 1)5 



display(mnp) /*di splays picture menu whose 



int mnp 5 

r 

‘ 

int tides 5 r? 



name 



i s 



mnameCmnp ]*/ 



fides = open ( mnameCmnp ] , 0_RD0NLY ) 5 
if (fides — 1) C 

teuton ( ) 5 
ECU < ) 5 
CUP (10,10)5 

pr intf < "Unab le to find picture file called Xs" ? mnameCmnp 3 ) ; 



\ 

J 


ex i t < 1 ) ; 




/* 


read past header 


*/ 


if 


( HEADER ! = 0 ) 






read C fides , buf ? 


HEADER) 5 


/# 


read picture */ 




r — 


; read ( fides , buf , 


PSIZE) ? 


3. f 


<r « -1) C 





t e x t o n ( ) 5 
EDU(); 

pr intf ( "Unable to load picture file called *As " , mnameCmnp 3) 5 
e x i t ( 1 ) ; 

j' 

c 1 ose ( f i des ) ; 
graphon ( ) ; 

graphmv ( 0 ? buf , PSIZE ) ; /*? ? calling parameters*/ 




p a k ( ) 



CUP ( BOTTOM - 1,1)5 

if (g input == ? H ? ! I g input == ? A ? ! ! g input == ? D ? ! ! edmode 
printf(" Press any key to continue 

gkev ( ) ; 

■k 

J 

else C 



pr intf ( " Press any switch to continue 

whi le( button ( ) == 855) 



CUP (BOTTOM - 1)5 
ELI < > 5 



ed i tmenu ( ) 

/ & all changes other than to individual entries */ 

r 

int key; 

iRJC rbo t ( ) ; 

~~ “jp ( BOTTOM - 4,1); 



oo 

/vV L.J 



printf ( " I ( input mods ) ; " ) 5 
CUP (BOTTOM - 3,1); 

pr intf( "N< number of entries); R (rename this menu); S(scan speed) 
pr intf ( "T ( type of menu ) ; " ) ; 

CUP ( BOTTOM - 2,1); 

pr intf ( "W< wr i te out all menus); X(do nothing)"); 
do 

r 

\ 

CUP (BOTTOM - 2*1)5 

pr intf ( " W ( wr i te out all menus); X(do nothing)" ) 5 
/#■ get choice ■*/ 
g e t s t r i n < 1 ) ; 
key = sbuf f C03 ? 
key “ toupper ( key ) 5 

switch (key) *C 

case ' A 2 
amenu( ) 5 
return ; 

case ’ D ? s 
dmenu ( ) ; 
return ? 

1 case " E ? s 

emenu ( ) ; 
return 5 

case ? I ? : 
i menu ( ) ; 
return 5 

case ? : 

nmenu( ) ; 

sho wmenu ( mname C menu 3 ) ; 
return; 

case ? R ? s 
rmenu ( ) ; 
return ; 

case ? S ' : 
smenu ( ) ; 
return ; 

case ? T *” : 
tmenu( ) ; 
return ; 

case 11 W ? s 
wmenu ( ) ; 
return ; 

case ’ X ’ : 
return ; 

default: 

CUP (BOTTOM - S, 1)5 
ELI ( ) ? 
break ; 

*> 

.y 

o 

ERIC jhile (TRUE); 

flMaffHKi333 
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amenu< > /^accepts and performs user request to add menu*/ 

r 

l. 

int key? savemenuj result; 
char type? 
char *sb ? 

do -C 

c Irbot ( ) 5 

CUP (BOTTOM - 3, 1 > S 
printf ( "New menuname" ) ; 
getstr in(MAXMNAME) ? 
sb = sbuff; 
wh i 1 e ( *sb ! = *\ 0 *) 

*sb++ = toupper ( *sb > ; 
result = addmenu ( sbuff ) ? 
c 1. rbo t ( > ; 

CUP (BOTTOM - 3? 1 > J 
switch (result) C 
case Os 

printf( "Don't forget to refer to the new menu and save all menus") 
break ? 
c ase 3. s 

printf ( "Sorryj no room for another name"); 
break ; 
case £: 

pr intf ( "Name already exists. " ) ; 
break ; 
defau 1 1 s 

pr intf ( " Addname f ai lure" ) ; 

*>. 

j 

p a k ( ) ? 

I* wh i le ( resu It > 1 ) ; 
savemenu = menu ; 
menu = menuct - 1? 
nmenu ( ) ; 

menu ~ savemenu ; 



dmenu( ) /^accepts and performs user request to delete menu*/ 

r 

v 

int result; 
char sC855]; 

c Irbot ( ) 5 

CUP (BOTTOM - 3? 1 ) ; 

if ( strcmp ( mnameCmenu] ? "MAIN" ) == 0) C 
printf ("You cannot delete MAIN"); 
p a k ( ) ; 
return ( 0 ) ; 



CUP (BOTTOM 



1 ) 



printf ("Do you really want to PERMANENTLY DESTROY this menu? (y/n)" )5 
getstr in ( 1 ) 5 

if (sbuff CO 3 == 'y' !! sbuff CO 3 == 7 Y 7 ) t 
del menu (mnameCmenu] ) ; 
showmenu ( "MAIN" ) ; 

O return*! 0) ; 

ERJC 

“rbot < ) ; 



<1 



/******************* **^*-fr****-fr-S-fr ***•/ 



©menu ( ) 

/^allows editing of an entry in a menu that is displayed on*/ 
/*the screen*/ 



int line, col? 
clrbot ( ) ? 

/* get. number of entry to change */ 
CUP ( BOTTOM - 3 , 1 ) ? 

pr irutf ( "Select entry to change > " ) ? 

i 

wh i 1 e < ( nen t r y = g e t i n ( > ) == - 1 ) 



/* get new label */ 

CUP (BOTTOM - 3,1); 

ELI ( ) ? 

CUP (BOTTOM - 3,1)5 

p r i n t f ( M 0 1 d label: 54 s \ n " , m 1 ab e 1 C menu 3 [ nen t r y II ) ? 

CUP (BOTTOM - ES1 > ? 
pr intf ( "New label " ) 5 
gets t r i n ( MAX LABEL ) 5 

/* add new label to memory */ 

mlabel Cmenu3 [nentry 3 = ma 1 1 oc ( s t r 1 en ( sbuf f > + 1)? 

if ( mlabel [menu 3 Cnentry II == NULL) err ("out of memory space" ) 

strcpy ( ml abel [menu] C nentry 3 * sbuf f ) ? 

/* write new label on screen at appropriate spot*/ 
i f ( nen t r y < ( ms i z e [ menu 3 + 1 ) / E ) C 

col = 6 ? 

line - nen t r y + B 5 

J' 

else C 

col « WIDTH/E + 55 

line = nentry — <msizeEmenu3+i > /B + E? 



CUP (line? col)? 
pr intf (EBLANKS) 5 
CUP (line, col); 
pr intf ( "54s" , sbuff ) ? 

/* get new phrase or action */ 
c 1 rbo t ( ) ? 

CUP (BOTTOM - 3,1)? 

pr intf ("Old phrase or menu name: 54s \n M , mtext C menu 3 Cnentry 3 ) 

CUP (BOTTOM - E, 1 ) ? 
pr intf ( "New" ) ? 
getstr in ( MAX TEXT ) ? 

/* add new text to menu */ 

mtextEmenu] [nentry 3 = mal loc ( str len ( sbuff ) * 1)? 

if ( mtext Cmenu3 Cnentry 3 -•= NULL) err ("out of memory")? 

strcpy ( mtextEmenu 3 C nentry 3 , sbuff ) ? 



r 

v. 



\ 

J 





*■***•**■*/ 




/* change input mode */ 



char c; 



do C 

c I r b o t ( ) 5 

CUP ( BOTTOM - 1 ); 5 

pr intf ( 11 Input Modes s A ( al 1 keys as one swi tah >5 D(d ivvided keyboard ) ; " ) 
CUP ( BOTTOM -3,1)5 

pr intf ( "K ( keyboard ) 5 S ( si ng 1 e swi tch ) 5 T ( twor sw i tehee ) " ),? 

CUP < BOTTOM -'2,1)5 .. ) 

pr intf ("Old mode was *Ac 5 New mode" , g input ) 
q e t s t r i n ( 1 ) 5 
c = sbuff [03 5 
c = toupper(c); 

> while (c != ? A ZZ. c: !=* :, D ? && c != ? K 7 ZZ c? ! = 

g input = c; 



nmenu( ) /* number of entries in current menu */;** • * 

r 

int oldsize, e? i? 
c 1 r b o t ( ) 5 

o 1 d s i z e = ms i z e C menu 3 ? ■ nt 

CUP (BOTTOM - 1); 5 

if ( msi zeCmenu] != 0) C t* 

pr intf ( “Warning — You will lose last -entries permanently if you " ) ; 
pr intf ( "reduce si 25." >5 s 

CUP (BOTTOM - 3, 1); i 



pr intf ( "Old Size = */d" 


? o 1 d s i z 


e ) 5 








' ( g type == *P 9 ) C 

do -C 






f 

\ 






CUP (BOTTOM - 2,1)5 






» 1 






pr intf ( "Choose a size 
gets t r i n ( 2 ) 5 


(4, 9, 


16, or 25)" 


) 5 <*• 






3- while ( !( sbuff [03 == 


ZZ 


sbuff [13 == 


"fX)’ ) 






ZZ ! ( sbuf f [03 


.*» m ? 

T 


ZZ SbLlff [13 


=b=*. NO" ) 






ZZ ! (sbuff C03 


“ 11 1 ? 


ZZ sbuff [13 


? 6 ? 


sbuf f [2] == 


’ \0 ? ) 


ZZ ! (sbuff [0 3 


— — ? P ? 


ZZ sbuff [13 




sbuff [23 == 


? \0 ? ) 



else C 
do C 

CUP (BOTTOM -2,1)5 * 

pr intf ( "Choose a size (1 to */.d> n , MAXENTR I ES > 5 
getstr in ( 2 ) 5 

if ( sbuf f [03 >= ? 1 ? ZZ sbuff [03 <= ’9’ 



( sbuff E13 == *\Q* 

! ! ( sbuf f C23 == *\Q 9 ZZ sbuff Cl 3 > = 

i = a to i ( sbuf f ) 5 



■C*’ ZZ Sbuf f [ 1 3 <= 9 ? ) ) 



else 



i = MAXENTR I ES + 1 



ERIC while < i > MAXENTR I ES) 5 
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msi se [menu] 



ato i ( sbuf f ) 5 



if (msiseCmenu] > oldsize) /* initialize new entries #/ 
for (e “■ oldsize; e < msizeCmenul; e++> 

mlabel [menu] Cel = mtex t [menu] Cel = &eos; 



/ £ * *r ■* * * *r * * * * * * Kr * it* ********** ■*■ -V- #■ *- ¥: / 

rmenu( ) /^accepts and performs user request to rename menu 
L 

int result; 
char *sb 5 

c 1 r b o t ( ) ? 

CUP (BOTTOM - 3,1); 

pr i ntf ( 11 New name of menu (press ENTER to keep old name)") 
getstr in(MAXMNAME) 5 
sb = sbuf f ; 
wh i 1 e ( *sb ! = ? \0 ? ) 

*sb++ = toupper ( *sb ) ; 
if (sbuffCO] « *\ 0 *) C 
c 1 r b o t ( ) ; 
retur n ? 



resul t = rnmenu ( sbuf f ) ; 
CUP (BOTTOM - £, 10) 5 
sw itch ( r esu It) C 

case 0 s 

break ? 



case 1 s 

pr intf ( “Both names are the same . 11 ) ; 
break ; 

case 2: 

pr intf ("No new name spec if ied . " ) 5 
break ; 

case 3: 

pr intf ( "New name already exists."); 
br e a k ? 

case h: 

pr intf <" 1 1 legal to rename MAIN."); 
b r ea k ; 

case 5: 

pr intf (“Not enough memory to store new name.") 5 
break ; 



def au 1 1 s 

pr intf ( “rename fai lure" ) ; 
break ; 



if (result == 0 &.L ( g type ===== ? T ? ! ! 

/■K-write name of menu centered on 
o CUP ( 0 ,1)5 
ELI < ) j 

CUP K>, WIDTH/2 - strlen(sbuff >/2> i 



ERIC 



edmode === 
line OVr/ 



" E : ’ > ) C 



pak < ) ; 






/ 




smenu. ( ) /*■ change scan rate *■/ 

r 

i n t i 5 



do C 



clrbot ( ) ; 

CUP (BOTTOM -3, 1)5 

pr intf < "Old speed is */*d : New Speed (1 to 30 ) 11 •» grate ) 5 

getstrin(E) 5 
i = a to i ( sbuf f > 5 
} while (i < 1 ! ! i > 30 ) 5 

grate = i 5 



tmenu( ) /* changes types of all menus */ 



i n t m ? 
c 1 r b o t ( ) 5 

CUP (BOTTOM - 3,1)5 

if ( g type == T 7 ) 

for (m = 05 m < menuct; m+*0 
switch (msizeCiTi] ) C 



case 16s 
case 25: 
break ? 

def au 1 1 : 

pr intf ( " 1 1 legal size menu for conversion to pictures 
pr i ntf ( M Ks" , mname Cm 1 ) s 
pak ( ) 5 



pr intf ( ” You now have " ) 5 
if ( g type =« 7 P 7 ) 

p r i n t f ( " p i c t ur e ” ) 3 

else 

pr intf ( "text" ) ; 

printf('* menus; do you want to change to " ) 5 
if ( g type «= 7 P 7 ) 

pr intf ( " text " ) ; 

else 

p r i n t f ( "pic t ur e " ) 3 
p r i n t f ( " menus ? ( y / n ) " ) 3 
get s tr i n ( 3 ) ; 

if ( sbuf ft 03 != 7 y 7 && sbuffCOH != 7 Y 7 ) 

O return; 




case 4 
case ? 



return ; 



j 





else 



g type = ? T * ; 

-« 

j 

/ * r * * * * * * * * Jr *•*#*#■■£• * * * * * * * * ■£ •* / 

wmenu( ) /*write out menu*/ 

r 

X . 

int result; 
clrbot < ) 5 

CUP (BOTTOM -3, 1); 

printf < "Writing out will overwrite the menus now on the disk. " ) ; 
CUP (BOTTOM - 2, 1)5 

pr intf ( "Are you ready to wr i te? < y/n ) " ) 5 
g e t s t r i n ( 3 ) ; 

if (sbuffCOD != ? y ? && sbuffEO] ! - J Y ? ) 
return ; 

resul t = outmenus ( "menus" ) ? 
clrbot ( ) 5 

CUP (BOTTOM - 3*1)5 
switch (result) { 

case Os 

printf < "Menus written successfully to file MENUS"); 
break; 

case 1 : 

printf ( "Unable to open file MENUS" ) 5 
break* 

case 2: 

pr intf ( "Unable to finishing writing file MENUS"); 
break ; 

def an 1 1 s 

pr intf < "Error in writing menus to disk"); 
break ; 

j' 

pak ( ) ; 



addmenu ( newname ? type ) /*adds a new menu*/ 
c h a r newn a me E ] ; 

r 

v. 

int entnum* mnum; 

/*does a menu already exist with this name?*/ 
for (mnum = 0; mnum < menuct; mnufn++) 

if ( strcmp ( newname * mname C mnum 3 ) == 0) return(l) ; /*name already exists*/ 

/*put new menu on list */ 

mname C menuc t J = ma 1 1 o c ( s t r 1 en ( newname ) + 1 ) 5 
if < mnameilmenuc t 3 == NULL) return(S) 5 
® r cpy ( mname [ menuc t 3 5 newname > ; 

:KLC 

entries to empty strino */ 
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m 1 a b s 1 C fit e n u c 1 3 E e n t n u m 3 == m t e x t [ m e n u c t '.1 [ e n t n u m 3 — & e d s ? 

/*We now have one more menu*/ 

++menuc t ? 

return (0) ? /*succeeded*/ 



/ .£ 4^ ^ g. £. .ft «. -ft ft. ft. ft. ft ft ft ft ft ft ft- ft ft. ft ft ft ft* * ft ft ft ft ft ft ft / 

de 3. menu ( menuname ) 

/♦delete name from menu list*/ 



/♦delete all references to menu*/ 
char menuname E 3 ? 



i n t m n u m ? e n t n u m ? 

/♦illegal to delete MAIN menu*/ 
i f ( s t r c mp < menuname ? " M A IN") “= 0 ) r eturn ( 1 > ; 

/♦delete from list? error if not on list*/ 
for (mnum = 1? mnum < menuct 5 mnum++) £ 

if ( strcmp < menuname 9 mnameC mnum 3 ) == 0) break? 

j 

if (mnum == menuct ) return (2); 

— menuct ?■ 

w h i 1 e ( m n u m < m e n u c t ) C 

mnameUmnuml = mname E mnum * 13? 

for (entnum = 0? entnum < msizeCmenu3 5 entnum++) 
m lab el II entnum 3 E mnum 3 = m label [entnum 3 Cmnum+1 3 ? 
mtext [entnum] [mnum] = mtext [entnum] [mnum+1 3 ; 



++mnum ? 



/♦remove all references to menuname*/ 
for(rrmum - 0? mnum < menuct? mnum *+) C 

for (entnum = 0? entnum < msizeEmenu]? entnum++) C 
i f (mt ex t [ mnum] [ entnum 3 [03 == * * ’ 

£> : u: strcmp < menuname ? mtext [mnum 3 [sntnum] + l ) == 0) 
m label [mnum] [entnum] ~ mtext [mnum] [entnum] = &eos ? 



rnmenu(newname) /^rename menu and all references to it*/ 
char newnamet 3 ? 

r 

int mnum? entnum? 
char *starname? 



/♦check for errors*/ 

/* both the same?*/ 

if ( strcmp ( mname[ menu ] ? newname ) == 0) return ( 1 ) ? 

/♦empty str ing?*/ 

if ( str 1 en ( mname [ menu 3 ) == 0 I! str len ( newname ) == 0) return ( 2 ) ? 

/♦newname a 1 ready exists?*/ 

for (mnum = 0? mnum < menuct? mnufn++) 

O if ( strcmp ( newname *> mname C mnum 3 ) == 0) return(3) ? 

ERIC 

i l l e q a 1 t o r e n a me 1 ’ S v l A I N 1 1 * / 




/♦set pointers to name and name with star*-/ 
starname — mal loc < str len < newname > + S) ; 
if .(starname “ NULL) return ( 5 ) ; 
st ar name [03 = 21 * 7 ; 
strcpy< starname + i ? newname); 

/^replace each reference to oldname with a reference to newname*/ 
for (mnum = 05 mnum < menuct J mnum++) 

for (sntnum = 0? entnum < msizetmenul 5 entnum++) 
if (< mtextEmnum] Centnuml C03 == 7 * 7 ) 

Z.l: strcmp < mnameCmenu] ? mtext [mnum] [entnum] + 1 > == 0) 
mtext [ mnum] [ entnum] = starname ; 

mnameCmenu] = starname + 1; 

return! 0 ) 5 



/*****************■' 

outmenus < f i lename ) /^collects garbage & outputs menus to filename*/ 
char f i lename [ 3 5 

f 

FILE *dfp5 

int met? entnum? mnum 5 
char s[ 53 ; 

/♦tentatively mark all menus as unreachable*/. 

for (mnum = 0? mnum < menuct; mnum++) mmarkCmnum] = 7 U 7 ; 

/*now mark all menus reachable from main*/ 

• mcheck ( “MAIN” ) ; 

/*now write out menus*/ 
of p = f open ( f i 1 ename ? " w '* ) ; 
if ( of p ==» NULL) return! 1 ) ? 

/* write out type */ 
aputc ( g type ? of p ) 5 
aputc ( *" \n 7 ? of p ) ; 

/ * wr i t e out i np ut mode */ 
aputc ( g input ? of p ) ; 
aputc ( 7 \n ? ? of p ) ; 

/* write out scan rate */ 
i toa < grate ? s > 5 
f puts ( s ? of p ) ; 
aputc ( ? \n 7 5 of p ) ; 

/♦count number of referenced menus and write out the count*/ 
met = 0; 

for (mnum -• 0; mnum < menuct; mnum++) if (mmarkCmnum] = 7 F: 7 ) ++mc t ; 
itoa(mctss) ; 
f puts < s ? of p ) ; 
aputc ( 7 \n 7 ? of p ) 5 

/♦write out referenced menus*/ 
for (mnum == 0? mnum < met; mnunrH-+) C 




i f ( mmar k [ mnum 3 



r 
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aputc ( ? Yn ? ? of p ) ? 



/* write out menu name */ 
f puts < mnameLmrtum] *ofp> 5 
aputc ( \n ,n ? of p ) s 

/* write out menu entries */ 

for (entnuffl - 05 entnum < msi zetmenu] 5 entnum++ ) 
f puts ( mlabel CmnumD [ entnum 3 ? of p > 5 
aputc ( ? Yn *’ ? of p ) 5 

f puts ( mtex t Comu(Ti3 [ entnum 3 * of p ) ; 
aputc ( ? \n *’ * of p ) 5 



fclose(ofp ) 5 



clrbot ( ) 

/^clears bottom four lines of screen*/ 

r 

CUP (BOTTOM -4*1)5 
EL 10 5 

CUP (BOTTOM - 3*1)5 
EL I ( ) 5 

CUP (BOTTOM - 2*1)5 
ELI ( ) 5 

CUP (BOTTOM - 1*1)5 
ELI ( ) 5 

CUP (BOTTOM* 1 > 5 
ELI ( ) 5 

keyson = FALSE? 



/********* ****** 

err ( s ) 
char st 3 5 

r 

\. 

texton( ) 5 

CUP (BOTTOM - 1*1)5 
ELI ( ) 5 

pr intf ( "%s” ,5); 
e x i t ( 1 ) 5 



*v 

J 



n 

j' 







H Copyright ( C ) 1983 

? StS=S 

^Copyright <C> 1983 by Manx 



Cg 

CODESEG 



graphmv. 
; syntax 



group CODESEG 
segment word public 
assume cs:Cg 
publ ic graphmv_ 
proc near 



r h o m a s F e n wic k 

Software S y s t e m 5 
'code' 



rep 

m v_.sk ip : 



done : 



graphmv. 



graphon. 



t ex ton 



EKLC 

SifliLBigKiTiaaaa 



is 1 i !•-: e 


b 1 ockmv ? 


(I'lDV 


bx * sp 


pushf 




c Id 




push 


es 


push 


si 


push 


d i 


ffiDV 


ax «. ObBOOh 


mov 


es ? ax 


mov 


d i 5 E C b x 3 


mov 


si ? 4 1 b x 3 


mov 


c x ? 6 C b x 3 


mov 


d x ? c x 


shr 


C X n 1 


j 2 


mv_sk ip 


move 


word ptr 


test 


dl ? 1 


j 2 


done 


mo vs 


byte ptr 


pop 


d i 


pop 


s i 


pop 


es 


popf 




ret 






endp 


pub lie 


gr aphc*n_ 


proc 


near 5 


push 


s i. 


push 


d i 


push 


bp 


mov 


ah ? 0 


mov 


a 1 ? 5 


i nt 


lOh 


pop 


bp 


pop 


d i 


pop 


si 


ret 




endp 




pub lie 


tex ton_ 


proc 


near ; 


push 


si 


push 


di 


push 


bp 


mov 


0 

IT. 

JC 

05 


mov 


al ,2 


int 


lOh 


pop 


bp 


p 0 p 


d i 


pop 


5 x 



Edi3? word ptr [si 3 



[ d i 3 ? byte ptr Esi3 



5 turns on med -res b & w graphics 



; turns on text (b Z. w) 



237 



te>;ton_ end p 

C0DESE6 ends 
end 



O 




5 last 


edited by 


p - m - 


? i 2 s 06 


p - m- ? Dec: 


. 11? 1984 


Cg 


group 


CODESEG 


CODESEG segment 


word public 




assume 


cs s Cg 




extrn 


$sav 2 near 




p ub 1 i c 


gscan_ 


gscan^ 


proc 


near 




mov 


a x ? 0 




call 


$5dV 




mov 


ah ? 0 




i nt 


1 6h 




mov 


a 1 ? ah ? we 




mov 


ah ? 0 




ret 




gecaru 


endp 




public zkey_ 




zkey_ 


proc near 




mov 


a x ? 0 




call 


$sav 




mov 


ah ? 1 




i nt 


16h 





jz short zky 5 if zero ? no 
mo v ah ? O 

ret . ia>: has code 



zky: 

mov ax ? £55 
ret 



zkey_ endp 
? 

public gkey_ 
gkey„ proc near 
mov axjO 
call $sav 
mov ah ? 0 



int 


16h 




mov 


ah ? 0 




ret 






Qkey_ 


endp 




5 


pub lie 


pittCfTu 


putcffi. 


proc 


near 




mov 


a x ? O 




call 


$sav 




fTiOV 


ax ? word 




mov 


ah ? 1 




mov 


dx ? word 




int 


14h 




r e t 




put cm. 


endp 




? 

CODESEG ends 






end 





p tr 
p tr 



? code ? 



want scan code 



code ava i 1 ab 1 e 



acbp: 

IOC bp I! 



«-v. 



ERIC 




□ 

Q 7 
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